eBay

Üye ol  |  Giriş yap
GittiGidiyor
GittiGidiyor API

Category Service

GittiGidiyor'da bulunan kategori bilgilerini içerir. Bir ürün listeleyebilmek için bu servisten alınacak kategori kodunun kullanılması gerekir. Kategori servisi aynı zamanda bir kategori içerisinde listelenecek ürünün teknik özelliklerinin hazır olarak verilmesini sağlar.

getCategoriesByCodes

Kategori kodu ile GittiGidiyorda bulanan kategori bilgilerine erişilir.



İ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: http://dev.gittigidiyor.com:8080/listingapi/ws/CategoryService?wsdl


Servis Metot İmzası:

CategoryServiceResponse getCategoriesByCodes (String [] categoryCodes, boolean withSpecs, boolean withDeepest,boolean withCatalog, String lang);


İstek Parametreleri:

categoryCodes: String []
Kategori bilgisi alınmak istenen kategori kodları.
withSpecs: boolean
Eğer true gönderilirse ekstra kategori detay bilgisi gönderilir. false olarak belirtilmişse gönderilmez.
withDeepest: boolean
Eğer true gönderilirse kategorinin alt veya ana kategori olduğunu belirten withDeepest parametresi döner. false olarak belirtilmişse bu parametre gönderilmez.
withCatalog: boolean
Eğer true gönderilirse katalog durumunu belirten withCatalog parametresi döner. false olarak belirtilmişse bu parametre gönderilmez.
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:

<cat:getCategoriesByCodes>
	<categoryCodes>
		<item>jgba</item>
	</categoryCodes>
	<withSpecs>true</withSpecs>
	<withDeepest>true</withDeepest>
	<withCatalog>true</withCatalog>
	<lang>tr</lang>
</cat:getCategoriesByCodes>


Sonuç Parametreleri:

categoryCount: int
Toplam kategori sayısı
categories: List<CategoryType>
Seçilen kategoriler, ayrıca bkz: CategoryType


Örnek Sonuç:

<cat:getCategoriesByCodesResponse xmlns:cat="http://category.anonymous.ws.listingapi.gg.com">
	<return>
		<ackCode>success</ackCode>
		<responseTime>18/10/2010 11:54:09</responseTime>
		<timeElapsed>46 ms</timeElapsed>
		<categoryCount>1</categoryCount>
		<categories>
			<category hasCatalog="false" deepest="true">
				<categoryCode>jgba</categoryCode>
				<categoryName>Yerli Takım Formaları</categoryName>
				<specs>
					<spec type="Combo" required="true" name="Beden">
						<values>
							<value>XS</value>
							<value>S</value>
							<value>M</value>
							<value>L</value>
							<value>XL</value>
							<value>XXL +</value>
							<value>Diğer</value>
						</values>
					</spec>
					<spec type="Combo" required="true" name="Sezon">
						<values>
							<value>2009-2010</value>
							<value>2008-2009</value>
							<value>2008 öncesi</value>
							<value>2010-2011</value>
							<value>2011-2012</value>
						</values>
					</spec>
					<spec type="Combo" required="true" name="Durumu">
						<values>
							<value>Yeni: Etiketli</value>
							<value>Yeni: Etiketsiz</value>
							<value>Kullanılmış</value>
							<value>Diğer</value>
						</values>
					</spec>
					<spec type="Combo" required="true" name="Marka">
						<values>
							<value>Adidas</value>
							<value>Asics</value>
							<value>Diadora</value>
							<value>Kappa</value>
							<value>Lotto</value>
							<value>Nike</value>
							<value>Puma</value>
							<value>Umbro</value>
							<value>Diğer</value>
						</values>
					</spec>
					<spec type="Combo" required="true" name="Takım">
						<values>
							<value>Beşiktaş</value>
							<value>Fenerbahçe</value>
							<value>Galatasaray</value>
							<value>Sivasspor</value>
							<value>Trabzonspor</value>
							<value>Türkiye Milli Takımı</value>
							<value>Diğer</value>
							<value>Bursaspor</value>
						</values>
					</spec>
					<spec type="Combo" required="true" name="Yetişkin / Çocuk">
						<values>
							<value>Yetişkin Forması</value>
							<value>Çocuk Forması</value>
						</values>
					</spec>
				</specs>
			</category>
		</categories>
	</return>
</cat:getCategoriesByCodesResponse>