Duyurular

Anonim

Kurumsal

Servisler

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.

postConversation

İki kişi arasında yeni bir sohbet başlatılmak istendiğinde kullanılan servistir. Belirtilen iki kişi, sonsuz sayıda aynı konu başlığı altında mesajlaşabilir ve bir konuşma en az bir tane mesaj içerir.

Kullanıcı adı girilerek direkt mesaj gönderilebilir (bkz: request 1) veya siparişe ait SC ile başlayan satış kodu girilerek otomatik kullanıcı adı bulunması sağlanarak (bkz: request 2) mesaj gönderilebilir.

İzin Hakları: Bu metodda kullanıcıların güvenliği için http protokolünün temel doğrulama (basic authentication) yöntemi kullanılır ve kurumsal servis katmanında işlem yapıldığı için servislere erişim esnasında uygulama anahtarı (apiKey), istek imzası (sign) ve o anki zaman değeri (timestamp) yollanarak istek (request) başına doğrulama gerçekleşir. Role ve Key bilgilerinize Api Anahtarları sayfanızdan ulaşabilirsiniz. Erişim: WSDL Adresi:https://dev.gittigidiyor.com:8443/listingapi/ws/IndividualUserConversationService?wsdl Servis Metot İmzası:Kopyala
UserConversationLoadingResponse getConversationById(String apiKey, String sign, long time, GetConversationByIdRequest getConversationByIdRequest);
İstek Parametreleri:Kopyala
apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    O anki zaman.
toUserNick: String
    Mesaj gönderilecek kullanıcının adı.
type: String
    Bu alan, "USER" ya da "SYSTEM" parametrelerini alabilir.
title: String
    Konu başlığıdır. Konu başlıkları getConversationSubject servisi ile çağrılabilir. 
context: Object
    Konuşmanın hangi ürün ile ilgili olduğu bilgisini içerir.
    Eğer konuşma "Aldıklarım" üzerinden başlarsa, içerisinde yer alan "sale" alanının altındaki "saleCode" alanına satış kodu eklenmelidir.
    Eğer ürün detay sayfasından başlatılırsa, içerisinde yer alan "product" alanının altındaki "productId"ye ürün bilgisi eklenmelidir.
messageText: String
    Gönderilecek mesajin 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:Kopyala
Request 1 (Kullanıcı adına göre yapılan istek)
<con:postConversation>
   <apiKey>NjgEHGeJc6cFqbw6FSUP8NpH3pUhV7ss</apiKey>
   <sign>5A761088EE585CC989C9CB7222AEF015</sign>
   <time>1602492702216</time>
   <postConversationRequest>
      <toUserNick>operasyontest</toUserNick>
      <type>USER</type>
      <messageText>API Test Mesaj İçeriği</messageText>
      <sendCopy>false</sendCopy>
      <lang>tr</lang>
   </postConversationRequest>
</con:postConversation>

Request 2 (Satış koduna göre yapılan istek)
<con:postConversation>
   <apiKey>NjgEHGeJc6cFqbw6FSUP8NpH3pUhV7ss</apiKey>
   <sign>5A761088EE585CC989C9CB7222AEF015</sign>
   <time>1602492702216</time>
   <postConversationRequest>
      <type>USER</type>
      <title>API Deneme Mesaj Başlığı</title>
      <context>
         <sale>
            <saleCode>SC107037299</saleCode>
         </sale>
      </context>
      <messageText>API Test Mesaj İçeriği</messageText>
      <sendCopy>false</sendCopy>
      <lang>tr</lang>
   </postConversationRequest>
</con:postConversation>
Sonuç Parametreleri:Kopyala
conversationId: String
    Servis çağrımı sonrasında dönen değerdir. Oluşturulan konuşmanın id'sidir.
Örnek Sonuç:Kopyala
Response 1
<con:postConversationResponse xmlns:con="http://conversation.individual.ws.listingapi.gg.com">
   <return>
      <conversationId>5f841c3fcb912600013a2bd7</conversationId>
   </return>
</con:postConversationResponse>

Response 2
<con:postConversationResponse xmlns:con="http://conversation.individual.ws.listingapi.gg.com">
   <return>
      <conversationId>5f84192e8c17c5000136e30b</conversationId>
   </return>
</con:postConversationResponse>

Servis Güncellemeleri