GittiGidiyor
GittiGidiyor API

Cargo Service

İstekte bulunan çoklu kullanıcının bu servis ile gerçekleştirebileceği işlemler şunlardır: Bireysel GittiGidiyor hesabındaki satış kodu ile kargo bilgisi listeleme, kargo bilgisi girme, girilen kargo bilgisini iptal etme.

sendCargoInformation

İlgili satış kodu girildikten sonra, satış bilgisine kargo bilgisi eklemek için kullanılır. Bu metot satıcılar tarafından 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/CommunityCargoService?wsdl


Servis Metot İmzası:

CommonSaleResponse sendCargoInformation(String apiKey, String sign, long time,String sessionId, long saleCode, String cargoPostCode, String cargoCompany, String cargoBranchCode, String followUpUrl, String lang);


İstek Parametreleri:

apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    O anki zaman.
sessionId: String
    Oturum anahtarı
saleCode: long
    Satış kodu.
cargoPostCode: String
    Kargo numarası.
cargoCompany: String
    Kargo şirketi.
cargoBranch: String
    Şube bilgisi.
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.
userType: String
     Kullanıcının alıcı ya da satıcı olduğu belirtilir (B / buyer, S / seller, N / none , A / all) .


Örnek İstek:

<car:sendCargoInformation>
   <apiKey>R5JHeKcn9kbedj92WSxURvx4tNQCydNu</apiKey>
   <sign>50d19a7b7f3fa535d924d426618d8a43</sign>
   <time>1257875674265</time>
   <sessionId>fnYE6gbsamQHFBMrQSxrbaZxNUeTSNng</sessionId>
   <saleCode>219663480001</saleCode>
   <cargoPostCode>123456789</cargoPostCode>
   <cargoCompany>mng</cargoCompany>
   <cargoBranch>Bandırma</cargoBranch>
   <followUpUrl>www.mngkargo.com</followUpUrl>
   <userType>S</userType>
   <lang>tr</lang>
</car:sendCargoInformation>


Sonuç Parametreleri:

ackCode: String
    İstek sonucu verilen geri dönüş kodu.
responseTime: Date
    İşlem yanıt zamanı
timeElapsed: Long
    Geçen süre


Örnek Sonuç:

<car:sendCargoInformationResponse xmlns:car="http://cargo.community.ws.listingapi.gg.com">
   <return>
      <ackCode>Kargo bilgisiniz başarıyla kaydedilmiştir</ackCode>
      <responseTime>10/11/2009 19:55:35</responseTime>
      <timeElapsed>13076 ms</timeElapsed>
   </return>
</car:sendCargoInformationResponse>