GittiGidiyor
GittiGidiyor API

Search Service

Arama servisi, GittiGidiyor müşterilerinin web sitesinde yapacağı aramaları karşılamak amacıyla tasarlanmıştır.

search

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) 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/SearchService?wsdl


Servis Metot İmzası:

SearchServiceResponse search(String keyword, SearchCriteriaType criteria, int startOffset, int rowCount,boolean includeDescription, boolean withData, String orderBy, String lang)


İstek Parametreleri:

keyword: String
    Arama yapılacak kelime (ürün)
format: String
    Ürün format F: Fixed Price, Sabit fiyatlı ürün A: Auction, Açık arttırma ü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: List
    Kategori ö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


Örnek İstek:

<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>
   <withData>true</withData>
   <orderBy>RI</orderBy>
   <lang>tr</lang>
</sear:search>


Sonuç Parametreleri:

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.


Örnek Sonuç:

<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>