Arama servisi, GittiGidiyor müşterilerinin web sitesinde yapacağı aramaları karşılamak amacıyla tasarlanmıştır.
GittiGidiyor üzerinde arama yapabilmek için bu metot kullanılır. Arama metodu GittiGidiyor?da bulunan arama ile bire bir aynı özelliklere sahiptir. Bu metotta dikkat edilmesi gereken husus startOffSet ve rowCount parametrelerinin mutlaka bir değer girilmesidir.
İzin Hakları:Bu metodun güvenliği için sadece http protokolünün temel doğrulama (basic authentication) yöntemi kullanılır. Web servis çağırımlarında kullanıcılar kendi Role Name ve Role Password bilgilerini kullanmalıdırlar. Role bilgilerinize Api Anahtarları sayfanızdan ulaşabilirsiniz.
Erişim: WSDL Adresi:https://dev.gittigidiyor.com:8443/listingapi/ws/SearchService?wsdl Servis Metot İmzası:Kopyalakeyword: String Arama yapılacak kelime (ürün) format: String Ürün format F: Sabit fiyatlı ürün S: Store, Dükkan ürünü freeShipping: Boolean true: Ücretsiz kargo özelliğine sahip ürünleri getirir. false:Ücretsiz kargo özelliğine bakılmadan ürünleri getirir. startFromOneTL: Boolean true: 1 TL'den başlayan ürünleri getirir. false: Başlangıç fiyatına bakılmaksızın ürünler getirilir. minPrice: Double Aranan ürün için isteğe bağlı belirlenecek fiyat aralığının minimum değerdir maxPrice: Double Aranan ürün için isteğe bağlı belirlenecek fiyat aralığının maksimum değerdir city: Integer Şehir kodu newItems: Integer gelenler Son 6-12-24 saati içinde bugünün ürünleri runOutItems: Integer Bitecek ürünler Son 2-6-12-24 saat icinde bugünün ürünleri finishedItems: Integer Biten ürünler Son 15-30 gün seller: String Satıcı ismi startOffSet: int Ürün başlangıç indeksi rowCount: int Kaç kayıt listeleneceği (Getirilecek satır sayısı) withData: boolean true: Listelenen ürünler detay bilgileri ile birlikte listelenir false: Sadece ürün anahtarları(id) listelenir orderBy: String Arama sonucunun hangi düzende sıralanacağını belirler RI - İlk bitecek ürünler NI - Yeni gelenler PA - Fiyat Azalan PD - Fiyat Artan IA - Ürün koduna göre artan ID - Ürün koduna göre azalan: default değer (orderBy boşsa) --> RI catalogOption: Boolean true: Katalog opsiyonu seçilmiş ürünler içerisinde arama yapar. false : Catalog opsiyonuna bakılmaksızın arama yapar. newProduct: Boolean true: Sıfır ürünleri getirir. false : Tüm ürünleri getirir. categoryCode: String Kategori kodu catalogId: Integer Katalog no categorySpecs: ListKategori özellik ismi ve değerini girerek arama kriteri oluşturma includeDescription: Boolean true : Ürün açıklamalarında da ara false: Ürün açıklamalarına bakılmaksızın ara
<sear:search>
<keyword>orjinal</keyword>
<criteria>
<format>F</format>
<freeShipping>false</freeShipping>
<startFromOneTL>false</startFromOneTL>
<catalogOption>true</catalogOption>
<newProduct>false</newProduct>
<minPrice>189.0</minPrice>
<maxPrice>190.0</maxPrice>
<city>34</city>
<runOutItems>24</runOutItems>
<seller>magicway</seller>
<categoryCode></categoryCode>
<catalogId></catalogId>
<categorySpecs>
<categorySpec name="Markalar" value="Tommy Hilfiger" />
</categorySpecs>
</criteria>
<startOffSet>0</startOffSet>
<rowCount>5</rowCount>
<includeDescription>false</includeDescription>
i<withData>true</withData>
i<orderBy>RI</orderBy>
i<lang>tr</lang>
</sear:search>
productId: Integer Ürün tekil anahtarı imageLink: String İmaj linki title: String Ürün başlığı format: String Ürün formatı bidCount: Integer Teklif sayısı price: Double Ürünün fiyatı remainingTime: Double Kalan süre count: Integer Ürün sayısı url: String Ürün linki seller: String Satıcının kullanıcı adı hasBuyNowPrice: Boolean true: Hemen Al fiyatı var. false: Hemen Al fiyatı yok buyNowPrice: Integer Hemen Al fiyatı categories: category Kategori ile ilgili bilgileri içerir.
<sear:searchResponse xmlns:sear="http://search.anonymous.ws.listingapi.gg.com">
<return>
<ackCode>success</ackCode>
<responseTime>01/12/2010 14:26:40</responseTime>
<timeElapsed>57 ms</timeElapsed>
<count>2</count>
<products>
<product>
<productId>32971169</productId>
<imageLink>http://mcdn01.gittigidiyor.net/3297/tn7/32971169_tn7_0.jpg</imageLink>
<url>http://urun.gittigidiyor.com/ORJINAL-TOMMY-HILFIGER-SAAT,-6-FARKLI-KULLANIM_W0QQidZZ32971169</url>
<title>ORJINAL TOMMY HILFIGER SAAT, 6 FARKLI KULLANIM</title>
<seller>magicway</seller>
<format>F</format>
<hasBuyNowPrice>true</hasBuyNowPrice>
<buyNowPrice>189.90</buyNowPrice>
<remainingTime>6 s : 33 dk</remainingTime>
</product>
<product>
<productId>32971080</productId>
<imageLink>http://mcdn01.gittigidiyor.net/3297/tn7/32971080_tn7_0.jpg</imageLink>
<url>http://urun.gittigidiyor.com/AMERIKADAN-ORJINAL-1710154-TOMMY-HILFIGER-SAAT_W0QQidZZ32971080</url>
<title>AMERIKADAN ORJINAL 1710154 TOMMY HILFIGER SAAT</title>
<seller>magicway</seller>
<format>F</format>
<hasBuyNowPrice>true</hasBuyNowPrice>
<buyNowPrice>189.90</buyNowPrice>
<remainingTime>6 s : 51 dk</remainingTime>
</product>
</products>
<categories>
<category>
<code>mskc</code>
<name>Kadın Kol Saati</name>
<count>2</count>
</category>
</categories>
</return>
</sear:searchResponse>
Hata Kodu | Mesaj | Çözüm |
Henüz listeye eklenmiş bir hata kodu bulunmamaktadır. |
API ile ürün listeleyen kullanıcılarımız için önemli bir güncelleme yayına alındı. Yeni güncelleme ile birlikte API üzerinde Sabit Fiyat (format = F) tipli ürün girişi kaldırılmıştır. Listelemeler için Mağaza (format = S) tipi tercih edilmelidir.
Product ServiceÜrünlere toplu AGT (Aynı Gün Teslimat) özelliği eklenebilmesi için yeni bir metot yayına alındı. Yayınlanan metoda bu link üzerinden ulaşabilirsiniz.
*Aynı Gün Teslimat Sözleşme'sine sahip olunması gerekmektedir.
Satılmadan kapanan ürünleri yeniden listelemek için kullanılan relistProducts metodunda güncelleme yapıldı. Stoğu 1'den az olan ürünler artık Aktif Satışlar'a alınamayacak ve uyarı dönecektir. Metoda bu link üzerinden ulaşabilirsiniz.
Product ServiceKategori servisinde kategori koduna ait minumum ve maximum kargolama sürelerini de takip edebileceğiniz bir güncelleme yayına alındı. Servis bilgilerine bu linkte yer alan Category Service başlığı altından ulaşabilirsiniz.
Category ServiceFiyat ve stok güncelleyen metotların statü kontrolü kaldırıldı. Yayınlanan güncelleme ile beraber aşağıda yer alan metotları Aktif Satışlar, Listelemeye Hazır Ürünler, Satılanlar ve Satılmayanlar alanında bulunan ürünler için kullanabilirsiniz.
updateProductSales
updatePrice
updatePriceByPercentage
updateStock
updateVariantStock
API ile ürün listeleyen kullanıcılarımız için önemli bir güncelleme yayına alındı. Yeni güncelleme ile birlikte artık API üzerinden para transferleri ve bakiye detaylarınızı takip edebilirsiniz.
Takip yapabilmeniz için ihtiyacınız olan dört farklı metot bilgilerine bu linkte yer alan Accounting Service başlığı altından ulaşabilirsiniz.
GittiGidiyor'a ürün eklemek için yeni bir metot yayına alındı. Bu metodu GittiGidiyor üzerinde ürün kaydetmek ve aynı zamanda listelenen ürünü Aktif Satışlar'a almak için kullanabilirsiniz. Metot bilgilerine bu link üzerinden ulaşabilirsiniz.
Product ServiceÜrün kaydetme servisinde aynı gün kargo seçeneği için yeni bir güncelleme yayına alındı. Güncelleme ile beraber artık aynı gün kargo yapılabilmesi için sipariş saati olarak 10:00-17:00 (beforeTime) saat aralığı seçilebilir hale getirildi.
Product Service