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.

markAsRead

Seçilen konuşmanın, ilgili kullanıcı için okundu olarak işaretlenmesini sağlayan 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ı:

UserConversationMarkingReadResponse markAsRead(String apiKey, String sign, long time,MarkAsReadRequest markAsReadRequest);


İstek Parametreleri:

apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    O anki zaman.
conversationId: String
    Okundu olarak işaretlenmesi istenen konuşmanın id'si.
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:markAsRead>
            <apiKey>R5JHeKcn9kbedj92WSxURvx4tNQCydNu</apiKey>
            <sign>14ead503f62cb4cd8d74a6e58cbbd005</sign>
            <time>1257876824896</time>
            <markAsReadRequest>
                <conversationId>5ce7d2d19f65940001ba4a16</conversationId>
                <lang>tr</lang>
            </markAsReadRequest>
        </con:markAsRead>
    </soapenv:Body>
</soapenv:Envelope>


Sonuç Parametreleri:

conversationRead: boolean
    Konuşmanın ilgili kullanıcı için okunup okunmadığı bilgisini döner.


Örnek Sonuç:

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
    <env:Header/>
    <env:Body>
        <con:markAsReadResponse xmlns:con="http://conversation.internal.ws.listingapi.gg.com">
            <return>
                <conversationRead>true</conversationRead>
            </return>
        </con:markAsReadResponse>
    </env:Body>
</env:Envelope>ışı