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.

insertProductWithNewCargoDetail

GittiGidiyor üzerinde ürün listelemek için bu metot kullanılır. Girilen ürün, GittiGidiyor Bana Özel sayfasında "Yeni Listelenenler" bölümünde görünecektir.



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

URL Adresi: https://dev.gittigidiyor.com:8443/listingapi/rlws/individual/product?method=insertProductWithNewCargoDetail


Servis Metot İmzası:

ProductServiceResponse insertProductWithNewCargoDetail(String outputCT, String inputCT, String apiKey, String sign, long time,String itemId, boolean forceToSpecEntry, boolean nextDateOption, String lang, ProductServiceRequest request);


İstek Parametreleri:

apiKey: String
Uygulamanızın anahtarı.
sign: String
Uygulamanın o anki isteğinin imzası.
time: long
O anki zaman.
itemId: String
Satışa konulan ürünün entegrasyon yapan firma tarafındaki ürün tekil anahtarı.
product: ProductType
Ürün bilgisini taşıyan nesne.
forceToSpecEntry: boolean
true : Kategori bazlı spec girişi zorunlu
false : Kategori bazlı spec girişi zorunlu değil
nextDateOption: boolean
true: İleri tarih opsiyonu var. startDate belirlenmelidir.
false: İleri tarih opsiyonu yok.
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.


https://dev.gittigidiyor.com:8443/listingapi/rlws/individual/product?method=insertProductWithNewCargoDetail&outputCT=xml&inputCT=xml&apiKey=ueYeyn9fGV3xmXuZSm9gVzJCPwEE6NTn&sign=a0f448c4496489595435b4e3057c6ddc&time=1289203956278&itemId=101gdk&lang=tr&forceToSpecEntry=false&nextDateOption=false


<request>
	<product>
		<categoryCode>gdk</categoryCode>
		<storeCategoryId></storeCategoryId>
		<title>Kodak Z915 12MP</title>
		<subtitle></subtitle>
		<specs>
			<spec name="Durumu" value="Kullanılmış" type="Combo" required="true" />
			<spec name="Çözünürlük (Megapiksel)" value="10.0 - 11.9 MP"
				type="Combo" required="true" />
			<spec name="Marka" value="Kodak" type="Combo" required="true" />
		</specs>
		<photos>
			<photo photoId="0">
				<url>http://images.gittigidiyor.com/2941/KODAK-Z915-10MP-10X-ZOOM-HD-SIFIR-URUN__29416457_0.jpg
				</url>
			</photo>
		</photos>
		<pageTemplate>1</pageTemplate>
		<description>Kodak Z915 Fotograf Makinesi 10Mp 50X zoom</description>
		<startDate></startDate>
		<catalogId></catalogId>
		<catalogDetail></catalogDetail>
		<format>S</format>
		<startPrice></startPrice>
		<buyNowPrice>240</buyNowPrice>
		<netEarning></netEarning>
		<listingDays>30</listingDays>
		<productCount>1</productCount>
		<cargoDetail>
			<city>34</city>
			<shippingPayment>B</shippingPayment>
			<shippingWhere>country</shippingWhere>
			<cargoCompanyDetails>
				<cargoCompanyDetail>
					<name>aras</name>
					<cityPrice>3.00</cityPrice>
					<countryPrice>5.00</countryPrice>
				</cargoCompanyDetail>
		       </cargoCompanyDetails>
		       <shippingTime>
				<days>today</days>
				<beforeTime>02:15</beforeTime>
		       </shippingTime>
		</cargoDetail>
		<affiliateOption>false</affiliateOption>
		<boldOption>false</boldOption>
		<catalogOption>false</catalogOption>
		<vitrineOption>false</vitrineOption>
	</product>
</request>


Sonuç Parametreleri:

productId: Integer
Ürün tekil anahtarı
result: String
Mesaj metni


<?xml version="1.0" encoding="UTF-8"?>
<return>
	<ackCode>success</ackCode>
	<responseTime>28/03/2013 15:01:23</responseTime>
	<timeElapsed>54 ms</timeElapsed>
	<productId>81743220</productId>
	<result>Ürün girişiniz başarıyla gerçekleştirilmiştir. Listeleme servisinden kontrol edebilirsiniz.</result>
</return>