Bir alıcıyla yazışmayı getir

Bir mağazada belirli bir alıcıdan gelen ve ona gönderilen mesajları tek listede döndürür.

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

İki sorgu birleştirilir: From alanı User ile eşleşen gelen mesajlar (tip 1) ve To alanı User ile eşleşen gönderilen mesajlar (tip 2). Silinmiş mesajlar dahil değildir.

Her sorgudan en fazla 20 mesaj alınır; yanıt en fazla 40 mesaj içerir ve en yeniden eskiye sıralıdır. Sayfalama yoktur. MessageCount iki sorgunun toplam kayıt sayılarının toplamıdır.

User eşleşmesi tam eşitlik değil, tam metin aramasıdır; benzer kullanıcı adları da eşleşebilir. MessageTypeId, BiggestIntegrationMessageId ve SmallestIntegrationMessageId bu uç noktada yok sayılır.

Mesajlar yalnızca N11 ve GittiGidiyor mağazaları için aktarılır. Başka hesaba ait bir StoreId boş liste döndürür.

İstek alanları

Alan	Tip	Açıklama
`ApiCode` zorunlu	string	`DoLogin` yanıtından aldığınız oturum kodu.
`StoreId` zorunlu	integer	Mağaza kimliği (`GetStores`).
`User` zorunlu	string	Alıcının pazaryeri kullanıcı adı (mesajlardaki `From`/`To` değeri).

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ı

Kod	Ne zaman
`00003`	`StoreId` eksik/0 veya `User` boş. `ErrorMessage` alan adını içerir (`StoreId` veya `User`).
`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,
  "User": "alici_123"
}

curl -X POST 'https://out.stockmount.com/api/Integration/GetAllUserMessage' \
  -H 'Content-Type: application/json' \
  -d '{
  "ApiCode": "API_CODE",
  "StoreId": 1234,
  "User": "alici_123"
}'

using System.Net.Http;
using System.Text;

using var http = new HttpClient();
var json = """
{
  "ApiCode": "API_CODE",
  "StoreId": 1234,
  "User": "alici_123"
}
""";

var response = await http.PostAsync(
    "https://out.stockmount.com/api/Integration/GetAllUserMessage",
    new StringContent(json, Encoding.UTF8, "application/json"));

var result = await response.Content.ReadAsStringAsync();
// Result == false ise ErrorCode ve ErrorMessage alanlarına bakın.
Console.WriteLine(result);

<?php
$body = <<<'JSON'
{
  "ApiCode": "API_CODE",
  "StoreId": 1234,
  "User": "alici_123"
}
JSON;

$ch = curl_init('https://out.stockmount.com/api/Integration/GetAllUserMessage');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (!$result['Result']) {
    echo $result['ErrorCode'] . ' ' . $result['ErrorMessage'];
}

import requests

payload = {
    "ApiCode": "API_CODE",
    "StoreId": 1234,
    "User": "alici_123"
}

response = requests.post("https://out.stockmount.com/api/Integration/GetAllUserMessage", json=payload, timeout=60)
result = response.json()

if not result["Result"]:
    print(result["ErrorCode"], result["ErrorMessage"])

const payload = {
  "ApiCode": "API_CODE",
  "StoreId": 1234,
  "User": "alici_123"
};

const response = await fetch("https://out.stockmount.com/api/Integration/GetAllUserMessage", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(payload),
});
const result = await response.json();

if (!result.Result) {
  console.error(result.ErrorCode, result.ErrorMessage);
}

Örnek yanıt

{
  "Result": true,
  "Response": {
    "MessageCount": 2,
    "Messages": [
      {
        "UserMessageId": 88131,
        "Code": "301245678_ANSWER_14",
        "Subject": "Ürün sorusu",
        "From": "ornekmagaza",
        "To": "alici_123",
        "MessageTypeId": 2,
        "Avatar": "",
        "Body": "Merhaba, ürün stoktadır.",
        "Time": "2026-11-05T09:10:14Z",
        "Unread": false,
        "Surname": "",
        "Name": "Mehmet K."
      },
      {
        "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.

Gövde (JSON)

{
  "ApiCode": "{{apiCode}}",
  "StoreId": 1234,
  "User": "alici_123"
}