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.

sendNewMessage

Mesaj gönderme işlemini yapmak 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ı:

UserMessageServiceIdResponse sendNewMessage(String apiKey, String sign, long time, String to, String title, String message, boolean sendCopy, String lang);


İstek Parametreleri:

apiKey: String
Uygulamanızın anahtarı.
sign: String
Uygulamanın o anki isteğinin imzası.
time: long
O anki zaman.
to: String
Gönderilecek kişinin GG üzerindeki kullanıcı ismi.
title: String
Mesajın konusu.
message: String
Mesaj içeriği.
sendCopy: boolean
true: Mesaj içeriğini kopyalar.
false: Herhangi bir kopya oluşturmaz
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:sendNewMessage>
	<apiKey>ueYeyn9fGV3xmXuZSm9gVzJCPwEE6NTn</apiKey>
	<sign>246593d7d6c40ade1d91466add446b09</sign>
	<time>1287417386785</time>
	<to>test_user2</to>
	<title>Deneme</title>
	<message>API send mesaj</message>
	<sendCopy>true</sendCopy>
	<lang>tr</lang>
</mes:sendNewMessage>


Sonuç Parametreleri:

ackCode: String
İstek sonucu verilen geri dönüş kodu.
responseTime: Date
İşlem yanıt zamanı
timeElapsed: Long
Geçen süre


Örnek Sonuç:

<mes:sendNewMessageResponse xmlns:mes="http://message.individual.ws.listingapi.gg.com">
	<return>
		<ackCode>success</ackCode>
		<responseTime>18/10/2010 18:57:39</responseTime>
		<timeElapsed>513 ms</timeElapsed>
		<result>Mesajınız (test_user2) kullanıcısına başarıyla gönderilmiştir.</result>
	</return>
</mes:sendNewMessageResponse>