GittiGidiyor
GittiGidiyor API

Application Service

Kullanıcı, kendisini "geliştirici" olarak sisteme kaydettirmesinin ardından sistem üzerinde kendi oluşturacağı yeni uygulamalar tanımlayabilir. Bir geliştirici birçok uygulama tanımlayabilir ve tanımladığı bu uygulamaları istediği zaman silebilir .

createApplication

Bu metot, GittiGidiyor kullanıcısının kendisini "geliştirici (developer)" olarak sisteme kaydettirmesinin ardından, kullanıcının sistem üzerinde kendi oluşturacağı uygulamaları tanımlayabilmesi için kullanılır. Bir geliştirici birden çok uygulama tanımlayabilir.



İ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/ApplicationService?wsdl


Servis Metot İmzası:

ApplicationServiceResponse createApplication(ApplicationInfoType applicationInfo, String lang)


İstek Parametreleri:

developerId: String
    Geliştiricinin tekil anahtarı
name: String
    Uygulamanın ismi
description: String
    Uygulama hakkında açıklama
accessType: String
    Erişim tipi

    I: Kurumsal kullanıcı
    C: Çok kullanıcılı(multi-user)
appType: String
    Uygulamanın tipi

    accessType=I için;
    M: Mobil uygulama
    W: Web uygulaması
    O: Diğer uygulama

    accessType=C için;
    D: Masaüstü uygulaması
    M: Mobil uygulama
    W- Web uygulaması
    O: Diğer uygulama
descDetail: String
    appType=O için; yani "Diğer" uygulama tipi seçilmiş ise uygulama tipi için detay açıklaması.
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:

<app:createApplication>
   <applicationInfo>
      <developerId>ZnNnxKRszYeGUnvB9ny9</developerId>
      <name>GittiGidiyor Api Uygulaması</name>
      <description>Kurumsal servis kullanılarak GittiGidiyor da işlem yapmak</description>
      <accessType>I</accessType>
      <appType>W</appType>
      <descDetail></descDetail>
      <successReturnUrl></successReturnUrl>
      <failReturnUrl></failReturnUrl>
   </applicationInfo>
   <lang>tr</lang>
</app:createApplication>


Sonuç Parametreleri:

apiKey: String
    Uygulamanın anahtarı
secretKey: String
    Uygulamanın şifresi
applicationName: String
    Uygulamanın ismi
description: String
    Uygulama hakkında açıklama
accessType: String
    Uygulamanın erişim tipi
applicationType: String
    Uygulama tipi
descDetail: String
    Uygulamanın detaylı açıklaması
registerDate: Date
    Uygulama kayıt tarihi
developerId: String
    Geliştiricinin tekil anahtarıdır


Örnek Sonuç:

<app:createApplicationResponse xmlns:app="http://application.anonymous.ws.listingapi.gg.com">
   <return>
      <ackCode>success</ackCode> 
      <responseTime>02/11/2010 17:02:48</responseTime>
      <timeElapsed>74 ms</timeElapsed>
      <application>
         <apiKey>ueYeyn9fGV3xmXuZSm9gVzJCPwEE6NTn</apiKey>
         <secretKey>Sfuf72n2HFXwXXCQ</secretKey>
         <name>GittiGidiyor Api Uygulaması</name>
         <description>Kurumsal servis kullanılarak GittiGidiyor da işlem yapmak</description>
         <accessType>I</accessType>
         <applicationType>W</applicationType>
         <descDetail/>
         <registerDate>02/11/2010 17:02:48</registerDate>
      </application>
      <developerId>ZnNnxKRszYeGUnvB9ny9</developerId>
   </return>
</app:createApplicationResponse>