API
English

API referansı · Mesajlar

Mesajları listele

Bir mağazanın pazaryerinden alınan mesajlarını tipe göre, en yeniden eskiye 20'şer kayıt halinde döndürür.

POST https://out.stockmount.com/api/Integration/GetUserMessages

Mesajlar pazaryerinden StockMount'a aktarılmış kayıtlardır. Kodda mesaj aktarımı yalnızca N11 (IntegrationId 2) ve GittiGidiyor (1) mağazaları için vardır; diğer mağazalarda liste boş gelir.

Her çağrı en fazla 20 mesaj döndürür, Time alanına göre en yeniden eskiye. Sayfa boyutu değiştirilemez.

Sayfalama kimlikle yapılır. Daha eski mesajlar için SmallestIntegrationMessageId alanına elinizdeki en küçük UserMessageId değerini gönderin; bu kimlikten küçük mesajlar gelir. Yeni mesajları almak için BiggestIntegrationMessageId alanına bildiğiniz en büyük UserMessageId değerini gönderin; bu kimlikten büyük mesajlar gelir. İki alan birlikte kullanılabilir.

Dikkat: Yalnızca BiggestIntegrationMessageId gönderdiğinizde 20'den fazla yeni mesaj varsa en yeni 20 mesaj gelir, aradakiler gelmez. Bu durumda BiggestIntegrationMessageId değerini koruyup SmallestIntegrationMessageId olarak son gelen en küçük kimliği göndererek geriye doğru devam edin.

MessageCount, filtreye uyan toplam mesaj sayısıdır. Başka hesaba ait bir StoreId hata vermez, boş liste döner.

Integration/GetUserMessage aynı işi yapan bir takma addır.

İstek alanları

Alan Tip Açıklama
ApiCode zorunlu string DoLogin yanıtından aldığınız oturum kodu.
StoreId zorunlu integer Mesajları listelenecek mağazanın kimliği (GetStores).
MessageTypeId zorunlu integer Mesaj tipi.
1
Gelen
2
Gönderilen
3
Silinmiş gelen
4
Silinmiş gönderilen
SmallestIntegrationMessageId integer İsteğe bağlı. Yalnızca UserMessageId değeri bundan küçük (daha eski) mesajları döndürür.
BiggestIntegrationMessageId integer İsteğe bağlı. Yalnızca UserMessageId değeri bundan büyük (daha yeni) mesajları döndürür.

Yanıt alanları (Response)

Alan Tip Açıklama
MessageCount integer Filtreye uyan toplam mesaj sayısı (dönen mesaj sayısı değil).
Messages object[] Mesajlar, en yeniden eskiye.
Messages[]. UserMessageId integer Mesajın StockMount kimliği. Sayfalama ve SetMessageRead için kullanılır.
Messages[]. Code string Mesajın pazaryerindeki kodu. N11 sorularında soru kimliğidir; yanıtlarken UserMessageCode olarak gönderin.
Messages[]. Subject string Mesaj konusu.
Messages[]. From string Gönderen (gelen mesajlarda alıcının pazaryeri kullanıcı adı).
Messages[]. To string Alıcı.
Messages[]. MessageTypeId integer Mesaj tipi.
1
Gelen
2
Gönderilen
3
Silinmiş gelen
4
Silinmiş gönderilen
Messages[]. Avatar string Alıcının görseli. Çoğunlukla boştur.
Messages[]. Body string Mesaj metni.
Messages[]. Time datetime Mesaj zamanı, UTC olarak ISO 8601 biçiminde (ör. 2026-11-05T08:42:10Z).
Messages[]. Unread boolean true: mesaj okunmadı.
Messages[]. Surname string Alıcının soyadı. Boş olabilir.
Messages[]. Name string Alıcının adı. Ad ve soyad kayıtlı değilse mesajdaki tam ad gelir.

Bu servisin hata kodları

KodNe zaman
00003 StoreId veya MessageTypeId eksik ya da 0. ErrorMessage alan adını içerir.
99999 Sunucu tarafında beklenmeyen bir hata oluştu (ör. veritabanı hatası). Bu uç noktada ErrorMessage çoğunlukla boş gelir.

Oturum hataları (00001, 00006) ve tüm kodlar için hata kodları.

İlgili servisler

Örnek istek

{
  "ApiCode": "API_CODE",
  "StoreId": 1234,
  "MessageTypeId": 1,
  "SmallestIntegrationMessageId": 88120
}

Örnek yanıt

{
  "Result": true,
  "Response": {
    "MessageCount": 57,
    "Messages": [
      {
        "UserMessageId": 88119,
        "Code": "301245678",
        "Subject": "Ürün sorusu",
        "From": "alici_123",
        "To": "ornekmagaza",
        "MessageTypeId": 1,
        "Avatar": "",
        "Body": "Bu ürün stokta var mı?",
        "Time": "2026-11-05T08:42:10Z",
        "Unread": true,
        "Surname": "",
        "Name": "Mehmet K."
      }
    ]
  }
}

Deneyin

İstek tarayıcınızdan doğrudan out.stockmount.com adresine gider. ApiCode bu sitede saklanmaz; yalnızca bu sekme açıkken tutulur.

İstek göndermek için önce ApiCode alın.

↑ ↓ ile gezinin, Enter ile açın, Esc ile kapatın.

Out API'ye bağlan

DoLogin çağrılır ve dönen ApiCode bu sekmede tutulur. API şifreniz bu siteye gönderilmez.