GittiGidiyor
GittiGidiyor API

Address Service

İstekte bulunan kurumsal kullanıcı, bu servis ile bireysel GittiGidiyor hesabında bulunan adres bilgilerine erişme

getAddressList

Bu metod, kullanıcının adres bilgilerine ulaşmak için kullanılır.



İ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. Ayrıca, kurumsal servis katmanında -servislere erişim esnasında- diğer katmanlarda olduğu gibi uygulama anahtarı, istek imzası ve o anki zaman değeri yollanarak istek (request) başına doğrulama gerçekleşir.



Erişim:

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


Servis Metot İmzası:

AddressServiceListResponse getAddressList( String apiKey, String sign, long time, int startOffset, int rowCount, String lang)


İstek Parametreleri:

apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    O anki zaman.
startOffSet: int
    Kaçıncı indeksten başlayacak?
rowCount: int
    Kaç kayıt listelenecek?
lang: String
    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:

<add:getAddressList>
   <apiKey>ueYeyn9fGV3xmXuZSm9gVzJCPwEE6NTn</apiKey>
   <sign>ba2e2f7ec8843d0a3b7f928ed3cb6f70</sign>
   <time>1281012792114</time>
   <startOffSet>0</startOffSet>
   <rowCount>2</rowCount>
   <lang>tr</lang>
</add:getAddressList>


Sonuç Parametreleri:

totalCount: int
    Toplam adres sayısı.
count: int
    İstek sonucu dönen adres sayısı
addresses: List<Address>
    Adres detay bilgisi.


Örnek Sonuç:

<add:getAddressListResponse xmlns:add="http://address.individual.ws.listingapi.gg.com">
   <return>
      <ackCode>success</ackCode>
      <responseTime>24/11/2010 10:38:27</responseTime>
      <timeElapsed>4 ms</timeElapsed>
      <totalCount>1</totalCount>
      <count>1</count>
      <addresses>
         <address>
            <addressId>3062785</addressId>
            <isDefault>true</isDefault>
            <name>Ahmet</name>
            <surname>Yılmaz</surname>
            <alias>Kozyatağı</alias>
            <address>Eski Üsküdar Yolu Cad. Çayıryolu Sok. No:1 Partaş Center K:16</address>
            <district>Ataşehir</district>
            <zipCode>34752</zipCode>
            <city>
               <trCode>34</trCode>
               <cityName>İstanbul</cityName>
            </city>
            <phoneNumber>216-5772136</phoneNumber>
            <gsmNumber></gsmNumber>
            <faxNumber />
         </address>
      </addresses>
   </return>
</add:getAddressListResponse>