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:

WSDL Adresi: http://dev.gittigidiyor.com:8080/listingapi/ws/CityService?wsdl


Servis Metot İmzası:

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


İstek Parametreleri:

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.


Örnek İstek:

<city:getCities>
	<startOffSet>10</startOffSet>
	<rowCount>4</rowCount>
	<lang>tr</lang>
</city:getCities>


Sonuç Parametreleri:

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


Örnek Sonuç:

<city:getCitiesResponse xmlns:city="http://city.anonymous.ws.listingapi.gg.com">
	<return>
		<ackCode>success</ackCode>
		<responseTime>19/01/2010 14:55:20</responseTime>
		<timeElapsed>0 ms</timeElapsed>
		<cityCount>84</cityCount>
		<cities>
			<city>
				<trCode>10</trCode>
				<cityName>Balıkesir</cityName>
			</city>
			<city>
				<trCode>11</trCode>
				<cityName>Bilecik</cityName>
			</city>
			<city>
				<trCode>12</trCode>
				<cityName>Bingöl</cityName>
			</city>
			<city>
				<trCode>13</trCode>
				<cityName>Bitlis</cityName>
			</city>
		</cities>
	</return>
</city:getCitiesResponse>