GittiGidiyor
GittiGidiyor API

Product Service

İstekte bulunan çoklu kullanıcının bu servis ile gerçekleştirebileceği işlemler şunlardır: Bireysel GittiGidiyor hesabındaki ürünlerin detay bilgilerine erişme, yeni ürün girişi, mevcut ürünü güncelleme, ürün kopyalama, ürün silme, erken bitirme, listeleme servisi altındaki yeni listelenen ürün listesini alma, listeleme servisi ve revizyon ücreti hesaplatma, listeleme ücreti ödeme.

getProducts

GittiGidiyor, Bana Özel sayfasında yer alan: Aktif Satışlarım, Yeni Listelenenler, Satılanlar, Satılmayanlar bölümündeki ürün 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: https://dev.gittigidiyor.com:8443/listingapi/ws/CommunityProductService?wsdl


Servis Metot İmzası:

ProductServiceListResponse getProducts(String apiKey, String sign, long time,String sessionId, int startOffset, int rowCount, String status , boolean withData, 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ı
startOffSet: int
    Kaçıncı indeksten başlayacak?
rowCount: int
    Kaç kayıt listelenecek?
status: String
    Durum parametresi(filtresi)
    A - Aktif Şatışlar
    L - Yeni Listelenenler
    S - Satılan Ürünler
    U - Satılmayan Ürünler
    R - Yeniden Listelenenler
withData: boolean
    true: Listelenen ürünler detay bilgileri ile birlikte listelenir.
    false: Sadece ürün anahtarları(id) listelenir.
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:

<prod:getProducts>
   <apiKey>R5JHeKcn9kbedj92WSxURvx4tNQCydNu</apiKey>
   <sign>58c139f08362941c9bd34cca3a4e0dc4</sign>
   <time>1257174354811</time>
   <sessionId>fnYE6gbsamQHFBMrQSxrbaZxNUeTSNng</sessionId>
   <startOffSet>0</startOffSet>
   <rowCount>3</rowCount>
   <status>A</status>
   <withData>true</withData>
   <lang>tr</lang>
</prod:getProducts>


Sonuç Parametreleri:

productCount: Long
    Toplam ürün sayısı
products: List
    Ürün detay listesi, ayrıca bkz: ProductDetailType


Örnek Sonuç:

<prod:getProductsResponse xmlns:prod="https://product.community.ws.listingapi.gg.com">
   <return>
      <ackCode>success</ackCode>
      <responseTime>02/11/2009 17:12:17</responseTime>
      <timeElapsed>0 ms</timeElapsed>
      <productCount>4</productCount>
      <products>
         <product>
            <productId>21767185</productId>
            <product>
               <categoryCode>tcn</categoryCode>
               <storeCategoryId>0</storeCategoryId>
               <title>API TEST ÜRÜNÜDÜR -TEKLİF VERMEYİNİZ - F10</title>
               <subtitle>api alt yazısı</subtitle>
               <specs />
               <photos>
                  <photo photoId="0">
                     <url>http://images.gittigidiyor.com/2176/21767185_0.jpg</url>
                  </photo>
               </photos>
               <pageTemplate>1</pageTemplate>
               <description>API için hazırlanmış ürün açıklamasıdır.</description>
               <catalogId>0</catalogId>
               <catalogDetail>0</catalogDetail>
               <format>A</format>
               <startPrice>1.4</startPrice>
               <buyNowPrice>98.9</buyNowPrice>
               <listingDays>7</listingDays>
               <productCount>1</productCount>
               <cargoDetail>
                  <city>10</city>
                  <cargoCompanies>
                     <cargoCompany>yurtici</cargoCompany>
                     <cargoCompany>mng</cargoCompany>
                     <cargoCompany>aras</cargoCompany>
                  </cargoCompanies>
                  <shippingPayment>B</shippingPayment>
                  <cargoDescription/>
                  <shippingWhere>country</shippingWhere>
               </cargoDetail>
               <affiliateOption>false</affiliateOption>
               <boldOption>true</boldOption>
               <catalogOption>false</catalogOption>
               <vitrineOption>false</vitrineOption>
            </product>
         </product>
         <product>
            <productId>21704103</productId>
            <product>
               <categoryCode>tcn</categoryCode>
               <storeCategoryId>0</storeCategoryId>
               <title>LÜTFEN TEKLİF VERMEYİNİZ - ÜRÜN 3</title>
               <specs>
                  <spec required="true" value="Anycool" name="Marka" />
                  <spec required="true" value="5454" name="Model" />
                  <spec required="true" value="Sıfır" name="Durumu" />
                  <spec required="true" value="Var, Devam ediyor" name="Garantisi" />
                  <spec value="3 Aydan az" name="Garanti Süresi" />
                  <spec value="Türkiye" name="Garanti Geçerlilik Yeri" />
                  <spec required="true" value="Var, Açılmamış" name="Kutusu" />
                  <spec value="Evet" name="Kayıt durumu" />
                  <spec value="&lt; 1.0 MP" name="Kamera" />
                  <spec value="16 MB ve altı" name="Dahili Hafıza" />
                  <spec value="Yok" name="Arttırılabilir Hafıza" />
                  <spec value="Yok" name="MP3 Çalma" />
                  <spec value="Yok" name="Radyo" />
                  <spec value="Yok" name="GPRS" />
                  <spec value="Yok" name="3G Desteği" />
                  <spec value="Yok" name="GPS" />
                  <spec value="Yok" name="Çift Hat Desteği" />
               </specs>
               <photos>
                  <photo photoId="0">
                     <url>http://images.gittigidiyor.com/2170/21704103_0.jpg</url>
                  </photo>
               </photos>
               <pageTemplate>2</pageTemplate>
               <description>deneme deneme deneme</description>
               <catalogId>0</catalogId>
               <catalogDetail>0</catalogDetail>
               <format>A</format>
               <startPrice>1.0</startPrice>
               <buyNowPrice>111.0</buyNowPrice>
               <listingDays>7</listingDays>
               <productCount>1</productCount>
               <cargoDetail>
                  <city>17</city>
                  <cargoCompanies>
                     <cargoCompany>yurtici</cargoCompany>
                     <cargoCompany>aras</cargoCompany>
                  </cargoCompanies>
                  <shippingPayment>B</shippingPayment>
                  <cargoDescription />
                  <shippingWhere>country</shippingWhere>
               </cargoDetail>
               <affiliateOption>false</affiliateOption>
               <boldOption>false</boldOption>
               <catalogOption>false</catalogOption>
               <vitrineOption>false</vitrineOption>
            </product>
         </product>
         <product>
            <productId>21704062</productId>
            <product>
               <categoryCode>tcn</categoryCode>
               <storeCategoryId>0</storeCategoryId>
               <title>LÜTFEN TEKLİF VERMEYİNİZ - ÜRÜN 1</title>
               <specs>
                  <spec required="true" value="Anycool" name="Marka" />
                  <spec required="true" value="5454" name="Model" />
                  <spec required="true" value="Sıfır" name="Durumu" />
                  <spec required="true" value="Var, Devam ediyor" name="Garantisi" />
                  <spec value="3 Aydan az" name="Garanti Süresi" />
                  <spec value="Türkiye" name="Garanti Geçerlilik Yeri" />
                  <spec required="true" value="Var, Açılmamış" name="Kutusu" />
                  <spec value="Evet" name="Kayıt durumu" />
                  <spec value="&lt; 1.0 MP" name="Kamera" />
                  <spec value="16 MB ve altı" name="Dahili Hafıza" />
                  <spec value="Yok" name="Arttırılabilir Hafıza" />
                  <spec value="Yok" name="MP3 Çalma" />
                  <spec value="Yok" name="Radyo" />
                  <spec value="Yok" name="GPRS" />
                  <spec value="Yok" name="3G Desteği" />
                  <spec value="Yok" name="GPS" />
                  <spec value="Yok" name="Çift Hat Desteği" />
               </specs>
               <photos>
                  <photo photoId="0">
                     <url>http://images.gittigidiyor.com/2170/21704062_0.jpg</url>
                  </photo>
               </photos>
               <pageTemplate>2</pageTemplate>
               <description>deneme deneme deneme</description>
               <catalogId>0</catalogId>
               <catalogDetail>0</catalogDetail>
               <format>A</format>
               <startPrice>1.0</startPrice>
               <buyNowPrice>0.0</buyNowPrice>
               <listingDays>7</listingDays>
               <productCount>1</productCount>
               <cargoDetail>
                  <city>17</city>
                  <cargoCompanies>
                     <cargoCompany>yurtici</cargoCompany>
                  </cargoCompanies>
                  <shippingPayment>B</shippingPayment>
                  <cargoDescription />
                  <shippingWhere>country</shippingWhere>
               </cargoDetail>
               <affiliateOption>false</affiliateOption>
               <boldOption>false</boldOption>
               <catalogOption>false</catalogOption>
               <vitrineOption>false</vitrineOption>
            </product>
         </product>
      </products>
   </return>
</prod:getProductsResponse>