T-SOFT/Storefront API/Destek Mesajları

Destek Mesajları

Bir destek talebine ait mesajları listeler, tekil görüntüler ve talebe yeni yanıt gönderir. Kimliği doğrulanmış müşteri token'ı gerektirir.

Yetki:storefront:account — müşteri token'ı zorunlu.

Listeleme

GET /support-ticket-messages

curl -s 'https://<domain>/api/v3/storefront/account/2026-01/support-ticket-messages?filter[ticketId]=1204' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>'

Örnek bir kayıt:

{
  "type": "support-ticket-messages",
  "id": "58120",
  "attributes": {
    "ticketId": 1204,
    "text": "Siparişim 5 gündür kargoda görünüyor.",
    "recordLink": "",
    "fromAdmin": false,
    "recordTime": 1736345400
  }
}

Alanlar

Alan	Açıklama	Yazılabilir
`ticketId`	Bağlı olduğu talep id'si	Evet
`text`	Mesaj metni	Evet
`recordLink`	Mesaja iliştirilen ek dosya/belge bağlantısı — bkz. recordLink semantiği	Salt-okunur
`fromAdmin`	Mesaj destek ekibinden mi geldi?	Salt-okunur
`recordTime`	Gönderilme zamanı (unix)	Salt-okunur

recordLink mesaja iliştirilmiş ek dosyanın (belge, görsel, PDF vb.) bağlantısıdır. Bir ek yoksa alan boş string döner (null değil) — istemci bağlantı bileşenini boş string kontrolüyle çizmelidir. Ek varsa değer, mağaza alan adı altında doğrudan açılabilen tam bir bağlantıdır. Bu alan salt okunurdur; mesaj oluştururken gönderilen ekler ayrı bir yükleme akışıyla eklenir, bu uca yazılmaz.

Filtreler

Filtre	Örnek	Davranış
`filter[ticketId]`	`filter[ticketId]=1204`	Belirli bir talebin mesajlarını getirir

Yeni yanıt gönderme

POST /support-ticket-messages

curl -s -X POST 'https://<domain>/api/v3/storefront/account/2026-01/support-ticket-messages' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>' \
  -d '{
    "data": {
      "type": "support-ticket-messages",
      "attributes": {
        "ticketId": 1204,
        "text": "Teşekkürler, takip numarasını gönderir misiniz?"
      }
    }
  }'

Oluşturma sırasında yalnızca ticketId ve text yazılabilir. fromAdmin müşteri gönderiminde her zaman false döner; destek ekibi yanıtlarında true olur.

Sıralama

Sort	Anlamı
`recordTime`	Gönderilme zamanına göre

Varsayılan sıralama recordTime,id (kronolojik; aynı saniyedeki mesajlar id ile stabilize edilir).