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.
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.
|
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.
|
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 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
}
curl -X POST 'https://out.stockmount.com/api/Integration/GetUserMessages' \
-H 'Content-Type: application/json' \
-d '{
"ApiCode": "API_CODE",
"StoreId": 1234,
"MessageTypeId": 1,
"SmallestIntegrationMessageId": 88120
}'
using System.Net.Http;
using System.Text;
using var http = new HttpClient();
var json = """
{
"ApiCode": "API_CODE",
"StoreId": 1234,
"MessageTypeId": 1,
"SmallestIntegrationMessageId": 88120
}
""";
var response = await http.PostAsync(
"https://out.stockmount.com/api/Integration/GetUserMessages",
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,
"MessageTypeId": 1,
"SmallestIntegrationMessageId": 88120
}
JSON;
$ch = curl_init('https://out.stockmount.com/api/Integration/GetUserMessages');
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,
"MessageTypeId": 1,
"SmallestIntegrationMessageId": 88120
}
response = requests.post("https://out.stockmount.com/api/Integration/GetUserMessages", json=payload, timeout=60)
result = response.json()
if not result["Result"]:
print(result["ErrorCode"], result["ErrorMessage"])
const payload = {
"ApiCode": "API_CODE",
"StoreId": 1234,
"MessageTypeId": 1,
"SmallestIntegrationMessageId": 88120
};
const response = await fetch("https://out.stockmount.com/api/Integration/GetUserMessages", {
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": 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.
Son istekler
Bu sekmeden gönderdiğiniz son istekler; birine tıklayınca gövdesi yeniden yüklenir.