eBay

Üye ol  |  Giriş yap
GittiGidiyor
GittiGidiyor API

User Messages Service

İstekte bulunan kurumsal 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:

WSDL Adresi: http://dev.gittigidiyor.com:8080/listingapi/ws/IndividualUserMessageService?wsdl


Servis Metot İmzası:

UserMessageServiceResponse getInboxMessages(String ApiKey, String sign, long time , int StartOffset, int rowCount, boolean unread, 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 mesajdan başlanılacağı.
rowCount: int
Kaç mesaj listeleneceği.
unread: boolean
true: Sadece okunmamış mesajlar listelenir
false: Gelen kutusundaki tüm mesajlar 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.


Örnek İstek:

<mes:getInboxMessages>
	<apiKey>ueYeyn9fGV3xmXuZSm9gVzJCPwEE6NTn</apiKey>
	<sign>1207ea7a33cfbd14da5c9b70b33bd120</sign>
	<time>1287411036527</time>
	<startOffSet>0</startOffSet>
	<rowCount>5</rowCount>
	<unread>false</unread>
	<lang>tr</lang>
</mes:getInboxMessages>


Sonuç Parametreleri:

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


Örnek Sonuç:

<mes:getInboxMessagesResponse xmlns:mes="http://message.individual.ws.listingapi.gg.com">
	<return>
		<ackCode>success</ackCode>
		<responseTime>18/10/2010 17:52:36</responseTime>
		<timeElapsed>7 ms</timeElapsed>
		<messageCount>4</messageCount>
		<messages>
			<message>
				<messageId>69263274</messageId>
				<from>test_user2</from>
				<to>test_user</to>
				<title>4</title>
				<messageContent>deneme</messageContent>
				<time>18/10/2010 17:51:13</time>
				<deleteTime>17/11/2010</deleteTime>
				<isRead>false</isRead>
			</message>
			<message>
				<messageId>69263243</messageId>
				<from>test_user2</from>
				<to>test_user</to>
				<title>3</title>
				<messageContent>deneme</messageContent>
				<time>18/10/2010 17:50:52</time>
				<deleteTime>17/11/2010</deleteTime>
				<isRead>false</isRead>
			</message>
			<message>
				<messageId>69263194</messageId>
				<from>test_user2</from>
				<to>test_user</to>
				<title>2</title>
				<messageContent>deneme</messageContent>
				<time>18/10/2010 17:50:18</time>
				<deleteTime>17/11/2010</deleteTime>
				<isRead>true</isRead>
			</message>
			<message>
				<messageId>69263162</messageId>
				<from>test_user2</from>
				<to>test_user</to>
				<title>deneme</title>
				<messageContent>api test mesajı</messageContent>
				<time>18/10/2010 17:49:52</time>
				<deleteTime>17/11/2010</deleteTime>
				<isRead>false</isRead>
			</message>
		</messages>
	</return>
</mes:getInboxMessagesResponse>