GittiGidiyor
GittiGidiyor API

User Messages Service

İstekte bulunan çoklu 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 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:8443/listingapi/ws/CommunityUserConversationService?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:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:con="http://conversation.individual.ws.listingapi.gg.com">
    <soapenv:Header/>
    <soapenv:Body>
        <con:getMessages>
            <apiKey>R5JHeKcn9kbedj92WSxURvx4tNQCydNu</apiKey>
            <sign>14ead503f62cb4cd8d74a6e58cbbd005</sign>
            <time>1257876824896</time>
            <getMessagesRequest>
                <conversationId>5ce7d2d19f65940001ba4a16</conversationId>
                <rowCount>5</rowCount>
                <startOffset>0</startOffset>
                <lang>tr</lang>
            </getMessagesRequest>
        </con:getMessages>
    </soapenv:Body>
</soapenv:Envelope>


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ç:

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
    <env:Header/>
    <env:Body>
        <con:getMessagesResponse xmlns:con="http://conversation.internal.ws.listingapi.gg.com">
            <return>
                <messages>
                    <message>
                        <messageText>Merhaba</messageText>
                        <messageId>12578260014</messageId>
                        <messageDate>2019-05-
                            29T15:57:05+03:00
                        </messageDate>
                        <senderNickName>kullanici_1</senderNickName>
                    </message>
                </messages>
            </return>
        </con:getMessagesResponse>
    </env:Body>
</env:Envelope>