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.

getCity

Bu metot, sadece tek bir şehir hakkında veriye ulaşılmak istendiğinde kullanılır. Ürün ekleme işlemi sırasında ilgili şehir bilgisinin girilmesi 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 ve her kullanıcıya özgü bir kullanıcı adı ve parolasının web servis çağırımlarında kullanılması gerekir.



Erişim:

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


Servis Metot İmzası:

CityServiceResponse getCity(int code, String lang);


İstek Parametreleri:

code: int
İstenilen şehrin kodu
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:getCity>
	<code>35</code>
	<lang>tr</lang>
</city:getCity>


Sonuç Parametreleri:

cities: List<CityType>
Seçilen şehir, ayrıca bkz: CityType


Örnek Sonuç:

<city:getCityResponse xmlns:city="http://city.anonymous.ws.listingapi.gg.com">
	<return>
		<ackCode>success</ackCode>
		<responseTime>19/01/2010 14:56:58</responseTime>
		<timeElapsed>1 ms</timeElapsed>
		<cities>
			<city>
				<trCode>35</trCode>
				<cityName>İzmir</cityName>
			</city>
		</cities>
	</return>
</city:getCityResponse>