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.

putMessage

Daha önce oluşturulmuş bir konuşmaya, yeni bir mesaj eklenmesi için çağrılan 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ı:

UserMessageAddingResponse putMessage(String apiKey, String sign, long time,PutMessageRequest putMessageRequest);


İstek Parametreleri:

apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    O anki zaman.
conversationId: String
    konuşma id'sidir. 
message: String
    Eklenecek mesajın içeriğidir.
sendCopy: boolean
    Mesaj gönderilirken mail yoluyla bildirim gönderilip gönderilmeyeceği bilgisini tutar.
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:putMessage>
            <apiKey> R5JHeKcn9kbedj92WSxURvx4tNQCydNu</apiKey>
            <sign> 14ead503f62cb4cd8d74a6e58cbbd005</sign>
            <time> 1257876824896</time>
            <putMessageRequest>
                <conversationId> 5ce7d2d19f65940001ba4a16</conversationId>
                <message>deneme</message>
                <sendCopy>true</sendCopy>
                <lang>tr</lang>
            </putMessageRequest>
        </con:putMessage>
    </soapenv:Body>
</soapenv:Envelope>


Sonuç Parametreleri:

updated: boolean
    Servis çağrımı başarılı ise updated alanı "true", değil ise "false" döner.


Örnek Sonuç:

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