eBay

Üye ol  |  Giriş yap
GittiGidiyor
GittiGidiyor API

Product Service

İstekte bulunan kurumsal 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/listingapi/ws/IndividualProductService?wsdl


Servis Metot İmzası:

ProductServiceListResponse getProducts(String apiKey, String sign, long time, 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.
startOffSet: int
Kaçıncı indeksten başlayacak?
rowCount: int
Kaç kayıt listelenecek?
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.
withData: boolean
true: Listelenen ürünler detay bilgileri ile birlikte listelenir.
false: Sadece ürün anahtarları(id) listelenir.


Örnek İstek:

<prod:getProducts>
	<apiKey>ueYeyn9fGV3xmXuZSm9gVzJCPwEE6NTn</apiKey>
	<sign>c71521855c5753b86015eab88e85d72c</sign>
	<time>1289223878908</time>
	<startOffSet>0</startOffSet>
	<rowCount>5</rowCount>
	<status>L</status>
	<withData>true</withData>
	<lang>tr</lang>
</prod:getProducts>


Sonuç Parametreleri:

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


Örnek Sonuç:

<prod:getProductsResponse xmlns:prod="https://product.individual.ws.listingapi.gg.com">
	<return>
		<ackCode>success</ackCode>
		<responseTime>08/11/2010 16:07:35</responseTime>
		<timeElapsed>58 ms</timeElapsed>
		<productCount>3</productCount>
		<products>
			<product>
				<itemId>100tcn</itemId>
				<productId>32520485</productId>
				<product>
					<categoryCode>tcn</categoryCode>
					<storeCategoryId>425198</storeCategoryId>
					<title>Nokia 6300</title>
					<specs>
						<spec required="true" value="Kullanılmış" name="Durumu" />
						<spec value="1.0 - 2.0 MP" name="Kamera" />
						<spec required="true" value="Nokia" name="Marka" />
					</specs>
					<photos>
						<photo photoId="0">
							<url>http://images.gittigidiyor.com/3252/32520485_0.jpg</url>
						</photo>
					</photos>
					<pageTemplate>1</pageTemplate>
					<description>Nokia 6300 Cep Telefonu 2MP kamera</description>
					<catalogId>0</catalogId>
					<catalogDetail>0</catalogDetail>
					<format>F</format>
					<buyNowPrice>150.0</buyNowPrice>
					<listingDays>7</listingDays>
					<productCount>1</productCount>
					<cargoDetail>
						<city>34</city>
						<cargoCompanies>
							<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>
				<summary>
					<listingStatus>L</listingStatus>
				</summary>
			</product>
			<product>
				<itemId>101gdk</itemId>
				<productId>32501420</productId>
				<product>
					<categoryCode>gdk</categoryCode>
					<storeCategoryId>0</storeCategoryId>
					<title>Kodak Z915 12MP</title>
					<specs>
						<spec required="true" value="Kullanılmış" name="Durumu" />
						<spec required="true" value="10.0 - 11.9 MP" name="Çözünürlük (Megapiksel)" />
						<spec required="true" value="Kodak" name="Marka" />
					</specs>
					<photos>
						<photo photoId="0">
							<url>http://images.gittigidiyor.com/3250/32501420_0.jpg</url>
						</photo>
					</photos>
					<pageTemplate>1</pageTemplate>
					<description>Kodak Z915 Fotograf Makinesi 10Mp 50X zoom</description>
					<catalogId>0</catalogId>
					<catalogDetail>0</catalogDetail>
					<format>S</format>
					<buyNowPrice>240.0</buyNowPrice>
					<listingDays>30</listingDays>
					<productCount>1</productCount>
					<cargoDetail>
						<city>34</city>
						<cargoCompanies>
							<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>
				<summary>
					<listingStatus>L</listingStatus>
				</summary>
			</product>
		</products>
	</return>
</prod:getProductsResponse>