eBay

Üye ol  |  Giriş yap
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<CategorySpecCriteriaType>
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>