eBay

Üye ol  |  Giriş yap
GittiGidiyor
GittiGidiyor API

City Service

GittiGidiyor sistemindeki şehir adları ve kodlarına erişmeyi sağlar. Şehir kodları, plaka kodlarından farklı olabileceği için değerlerin bu servisten kontrol edilmesi gerekebilir.

getCities

GittiGidiyor daki bütün şehir bilgilerine ulaşmak için kullanılır. Ürün ekleme işlemi sırasında ilgili şehir bilgisinin (şehir adları ve kodları) belirtilmesi gerektiği için bu bilginin gönderilmesi zorunludur.



İzin Hakları:

Bu metodun güvenliği için sadece http protokolünün temel doğrulama (basic authentication) metodu kullanılır. Web servis çağırımlarında kullanıcılar kendi kullanıcı adlarını ve parolalarını kullanmalıdırlar.



Erişim:

URL Adresi: http://dev.gittigidiyor.com:8080/listingapi/rlws/anonymous/city?method=getCities


Servis Metot İmzası:

CityServiceResponse getCities(int startOffset, int rowCount, String lang, String outputCT);


İstek Parametreleri:

method: String
İlgili servisin metod adını belirlemeye yarar.
startOffSet: int
Kaçıncı indeksten başlayacak?
rowCount: int
Kaç kayıt listelenecek?
lang: boolean
Olası bir hata anında dönen hata mesajının dilini belirtmek için kullanılır.

Hata mesajı lang=tr ise Türkçe,
lang=en ise İngilizce olarak çıkar.
outputCT: String
Sonuç olarak alınacak verinin formatı(XML, JSON).


http://dev.gittigidiyor.com:8080/listingapi/rlws/anonymous/city?method=getCities&outputCT=xml&startOffSet=0&rowCount=5&lang=tr


Sonuç Parametreleri:

cityCount: Integer
Toplam şehir sayısı
cities: List<CityType>
Seçilen şehirler, ayrıca bkz: CityType


<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<return>
	<ackCode>success</ackCode>
	<responseTime>19/01/2010 15:25:43</responseTime>
	<timeElapsed>0 ms</timeElapsed>
	<cityCount>84</cityCount>
	<cities>
		<city>
			<trCode>0</trCode>
			<cityName>Belirtilmemiş</cityName>
		</city>
		<city>
			<trCode>1</trCode>
			<cityName>Adana</cityName>
		</city>
		<city>
			<trCode>2</trCode>
			<cityName>Adıyaman</cityName>
		</city>
		<city>
			<trCode>3</trCode>
			<cityName>Afyon</cityName>
		</city>
		<city>
			<trCode>4</trCode>
			<cityName>Ağrı</cityName>
		</city>
	</cities>
</return>