eBay

Üye ol  |  Giriş yap
GittiGidiyor
GittiGidiyor API

User Messages Service

İstekte bulunan çoklu kullanıcı, bu servis ile bireysel GittiGidiyor hesabındaki mesajlara ulaşma ve yeni mesaj gönderme işlemlerini yapabilir.

getInboxMessages

Gelen mesaj bilgilerine erişmek 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:

URL Adresi: http://dev.gittigidiyor.com:8080/listingapi/rlws/community?method=getInboxMessages


Servis Metot İmzası:

UserMessageServiceResponse getInboxMessages(String apiKey, String sign, long time,String sessionId, int startOffset, int rowCount, boolean newOnly, boolean withData, String lang, String outputCT);


İstek Parametreleri:

method: String
İlgili servisin metod adını belirlemeye yarar.
apiKey: String
Uygulamanızın anahtarı.
sign: String
Uygulamanın o anki isteğinin imzası.
time: long
O anki zaman.
sessionId: String
Oturum anahtarı
startOffSet: int
Hangi mesajdan başlanılacağı.
rowCount: int
Kaç mesaj listeleneceği.
newOnly: boolean
true: Sadece okunmamış mesajlar listelenir
false: Gelen kutusundaki tüm mesajlar listelenir.
withData: boolean
true: Mesaj bilgileri ilişkili veriler ile beraber listelenir
false: Sadece mesaj numaraları listelenir
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.
outputCT: String
Sonuç olarak alınacak verinin formatı(XML, JSON).


http://dev.gittigidiyor.com:8080/listingapi/rlws/community/message?method=getInboxMessages&outputCT=xml&apiKey=R5JHeKcn9kbedj92WSxURvx4tNQCydNu&sign=f812e8c3496fa799904fd03f9ca289ad&time=1258559513459&sessionId=fnYE6gbsamQHFBMrQSxrbaZxNUeTSNng&startOffSet=0&rowCount=5&unread=true&lang=tr


Sonuç Parametreleri:

messageCount: Integer
Mesaj sayısı
messages: List<UserMessageType>
Mesaj içeriği, ayrıca bkz: UserMessageType


<?xml version="1.0" encoding="UTF-8"?>
<return>
	<ackCode>success</ackCode>
	<responseTime>18/11/2009 17:57:16</responseTime>
	<timeElapsed>0 ms</timeElapsed>
	<messageCount>2</messageCount>
	<messages>
		<message>
			<from>gg_test_411</from>
			<to>gg_test_82</to>
			<time>18/11/2009 11:37:51</time>
			<title>22088894:LÜTFEN TEKLİF VERMEYİNİZ - APİ TEST 100</title>
			<messageContent>bu ürün hakkında soru</messageContent>
		</message>
		<message>
			<from>gg_test_500</from>
			<to>gg_test_82</to>
			<time>18/11/2009 11:36:57</time>
			<title>22088894:LÜTFEN TEKLİF VERMEYİNİZ - APİ TEST 100</title>
			<messageContent>ürün hakkında soru</messageContent>
		</message>
	</messages>
</return>