GittiGidiyor
GittiGidiyor API

User Messages Service

İstekte bulunan kurumsal kullanıcı, bu servis ile bireysel GittiGidiyor hesabındaki mesajlara ulaşma, yeni mesaj/mesajlar gönderme, mesajı/mesajları silme, okundu ve okunmadı olarak işaretleme işlemlerini yapabilir.

getMessages

Bir konuşma içerisinde bulunan mesajları getiren servistir.



İzin Hakları:

Bu metodda kullanıcıların güvenliği için http protokolünün temel doğrulama (basic authentication) metodu kullanılır. Bu doğrulama için gerekli bilgileri API Anahtarları sayfanızdan kontrol edebilirsiniz. Web servis çağırımlarında kullanıcılar kendi role name ve role passwordlerini kullanmalıdırlar. Ayrıca, kurumsal servis katmanında işlem yapılır ise -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:https://dev.gittigidiyor.com:8443/listingapi/ws/IndividualUserConversationService?wsdl


Servis Metot İmzası:

UserMessageLoadingResponse getMessages(String apiKey, String sign, long time, GetMessagesRequest getMessagesRequest);


İstek Parametreleri:

apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    O anki zaman.
conversationId: String
    Listelenmesi istenen mesajların konuşma id'sidir.
rowCount: integer
    Kaç mesaj listeleneceği.
startOffSet: integer
    Kaçıncı indeksten başlayacak?
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:

<con:getMessages>
   <apiKey>RXpvxeENHMQjwhEB5HtxZGTdJ3KvRguv</apiKey>
   <sign>AAD89884830DCCEC004B43F422B3FC30</sign>
   <time>1588163921542</time>
   <getMessagesRequest>
      <conversationId>5ea975ad99b3810001892e12</conversationId>
      <rowCount>5</rowCount>
      <startOffset>0</startOffset>
      <lang>tr</lang>
   </getMessagesRequest>
</con:getMessages>


Sonuç Parametreleri:

messageText: String
    Gönderilen mesajin içeriğidir.
messageId: integer
    Gönderilen mesajın id'sidir.
messageDate: Date
    Mesajın gönderildiği tarihtir.
senderNickName: String
    Gönderen kişinin kullanıcı adıdır.


Örnek Sonuç:

<con:getMessagesResponse xmlns:con="http://conversation.individual.ws.listingapi.gg.com">
   <return>
      <messages>
         <message>
            <messageId>697676772</messageId>
            <messageText>API test mesaj</messageText>
            <messageDate>2020-04-29T15:40:13+03:00</messageDate>
            <senderNickName>testdenem2</senderNickName>
         </message>
      </messages>
   </return>
</con:getMessagesResponse>