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.

getModifiedCities

Bu metot, belirtilen tarihten şimdiki zamana kadar şehir adları, kodları değişmiş olan şehirleri listelemek için kullanılır. Bu metodu kullanarak, değişiklikleri güncellemek için her seferinde bütün şehirlere ait veriyi çekmek yerine, sadece belirtilen tarihten sonra gerçekleşmiş olan değişiklikleri çekebilirsiniz.



İ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ı:

CityServiceAuditResponsegetModifiedCities(long changeTime, int startOffset, int rowCount, String lang);


İstek Parametreleri:

changeTime: long
Hangi tarihten itibaren değişen dataların istendiği belirtilir.
Gireceğiniz tarih UNIX timestamp çevrilmiş değerini girmelisiniz.
Örn: 11-Sep-2010 00:00:00 1284163200000 Unix timestamp değeri
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:getModifiedCities>
	<changeTime>1284163200000</changeTime>
	<startOffSet>0</startOffSet>
	<rowCount>5</rowCount>
	<lang>tr</lang>
</city:getModifiedCities>


Sonuç Parametreleri:

cityCount: Integer
Toplam değişen şehir sayısı
cities: List<CityType>
Değişen şehirler, ayrıca bkz: CityType


Örnek Sonuç:

<city:getModifiedCitiesResponse xmlns:city="http://city.anonymous.ws.listingapi.gg.com">
	<return>
		<ackCode>success</ackCode>
		<responseTime>19/01/2010 14:58:24</responseTime>
		<timeElapsed>41 ms</timeElapsed>
		<cityCount>0</cityCount>
		<cities />
	</return>
</city:getModifiedCitiesResponse>