eBay

Üye ol  |  Giriş yap
GittiGidiyor
GittiGidiyor API

Activity Service

İstekte bulunan kurumsal kullanıcı, bu servisi kullanarak bireysel GittiGidiyor hesabında bulunan; aktif satıştaki, satılan, satılmayan, kazandığı, kazanamadığı, izlediği ve teklif verdiği ürünler hakkında bilgi sahibi olur.

getSoldItems

Bana Özel sayfasında, Durum > Sattıklarım başlığı altında yer alan bilgilere ulaşmak için kullanılır. Bu metot sayesinde satılan ürünlerin; ürün numarası, başlığı, ürün linki, formatı, satış fiyatı, adeti, bitiş tarihi, son işlem tarihi, durum açıklaması, kargo detayı, satış kodu, alıcının işlem sayısı gibi bilgilerine ulaşı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: http://dev.gittigidiyor.com:8080/listingapi/ws/IndividualActivityService?wsdl


Servis Metot İmzası:

ActivitySoldResponse getSoldItems( String apiKey, String sign, long time, int startOffset, int rowCount,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
Hangi üründen başlanılacağı.
rowCount: int
Kaç tane ürünün listeleneceği.
withData: boolean
true: Ürün bilgileri, ilişkili veriler ile beraber listelenir
false:ÜrünId'leri ve Eğer ürün satılmış ise satış kodlarını beraber listeler.
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:

<act:getSoldItems>
	<apiKey>ueYeyn9fGV3xmXuZSm9gVzJCPwEE6NTn</apiKey>
	<sign>ae1306b7b37f9801cfc758de4b2daf8e</sign>
	<time>1289478886747</time>
	<startOffSet>0</startOffSet>
	<rowCount>5</rowCount>
	<withData>true</withData>
	<lang>tr</lang>
</act:getSoldItems>


Sonuç Parametreleri:

count: int
Ürün sayısı.
itemList: itemList
Ürün bilgisini taşıyan nesne.


Örnek Sonuç:

<act:getSoldItemsResponse xmlns:act="http://activity.individual.ws.listingapi.gg.com">
	<return>
		<ackCode>success</ackCode>
		<responseTime>11/11/2010 14:36:24</responseTime>
		<timeElapsed>14 ms</timeElapsed>
		<count>2</count>
		<itemList>
			<item>
				<itemId>100gcf</itemId>
				<productId>32547996</productId>
				<title>Fotograf makinesi için çanta</title>
				<productLink>http://urun.gittigidiyor.com/Fotograf-makinesi-icin-canta_W0QQidZZ32547996</productLink>
				<photos>
					<photo photoId="0">
						<url>http://images.gittigidiyor.com/3254/32547996_0.jpg</url>
					</photo>
				</photos>
				<format>F</format>
				<price>1.0</price>
				<paidPrice>1.0</paidPrice>
				<productCount>1</productCount>
				<endDate>09/11/2010 15:30:08</endDate>
				<lastProcessDate>09/11/2010 15:38:55</lastProcessDate>
				<status>6</status>
				<statusDescription>Alıcı ürüne onay verdi</statusDescription>
				<cargoDetail>
					<shippingPayment>1</shippingPayment>
					<cargoCompany>Aras Kargo - Kozyatağı</cargoCompany>
					<cargoCode>11223344556677889900</cargoCode>
				</cargoDetail>
				<saleCode>325479960001</saleCode>
				<buyerProcessCount>2</buyerProcessCount>
				<thumbImageLink>http://mcdn01.gittigidiyor.net/3254/tn9/32547996_tn9_0.jpg</thumbImageLink>
			</item>
			<item>
				<itemId>101gcf</itemId>
				<productId>32633222</productId>
				<title>Fotograf makinesi için çanta</title>
				<productLink>http://urun.gittigidiyor.com/Fotograf-makinesi-icin-canta_W0QQidZZ32633222</productLink>
				<photos>
					<photo photoId="0">
						<url>http://images.gittigidiyor.com/3263/32633222_0.jpg</url>
					</photo>
				</photos>
				<format>F</format>
				<price>1.0</price>
				<paidPrice>1.0</paidPrice>
				<productCount>1</productCount>
				<endDate>18/11/2010 13:57:11</endDate>
				<lastProcessDate>11/11/2010 14:18:11</lastProcessDate>
				<status>6</status>
				<statusDescription>Alıcı ürüne onay verdi</statusDescription>
				<cargoDetail>
					<shippingPayment>1</shippingPayment>
					<cargoCompany>Diger - Kozyatağı</cargoCompany>
					<cargoCode>3256125422</cargoCode>
				</cargoDetail>
				<saleCode>326332220001</saleCode>
				<buyerProcessCount>2</buyerProcessCount>
				<thumbImageLink>http://mcdn01.gittigidiyor.net/3263/tn9/32633222_tn9_0.jpg</thumbImageLink>
			</item>
		</itemList>
	</return>
</act:getSoldItemsResponse>