T-SOFT/Storefront API/Destek Talepleri

Destek Talepleri

Oturum açmış müşterinin destek taleplerini listeler, tekil olarak görüntüler ve yeni talep oluşturur. Kimliği doğrulanmış müşteri token'ı gerektirir.

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

Listeleme

GET /support-tickets

curl -s 'https://<domain>/api/v3/storefront/account/2026-01/support-tickets' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>'

Örnek bir kayıt:

{
  "type": "support-tickets",
  "id": "1204",
  "attributes": {
    "title": "Kargom hâlâ gelmedi",
    "departmentId": 3,
    "departmentName": "Kargo",
    "isReplied": true,
    "status": "open",
    "recordTime": 1736345400,
    "updateTime": 1736431800
  }
}

Tek talep

GET /support-tickets/{id}

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

Yanıt, listedeki kaydın aynısıdır (data tekil obje olarak döner). Talep detay ekranında yazışmayı da aynı istekte almak için ?include=messages kullan — bkz. Mesajlar.

Başka bir müşterinin talebi istendiğinde 404 alınır; mesajları da hiçbir koşulda dönmez.

Alanlar

Alan	Açıklama	Yazılabilir
`title`	Talep başlığı	Evet
`departmentId`	İlgili departman id'si	Evet
`departmentName`	Departman adı	Salt-okunur
`isReplied`	Talebe yanıt verildi mi?	Salt-okunur
`status`	Talep durumu	Salt-okunur
`recordTime`	Oluşturulma zamanı (unix)	Salt-okunur
`updateTime`	Son güncelleme zamanı (unix)	Salt-okunur

İlk mesaj metni (text) listede ve tekil görünümde gizlidir. Talep gövdesini okumak için messages ilişkisini kullan (aşağıya bak).

Yeni talep oluşturma

POST /support-tickets

curl -s -X POST 'https://<domain>/api/v3/storefront/account/2026-01/support-tickets' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>' \
  -d '{
    "data": {
      "type": "support-tickets",
      "attributes": {
        "title": "Kargom hâlâ gelmedi",
        "departmentId": 3,
        "text": "Siparişim 5 gündür kargoda görünüyor."
      }
    }
  }'

Oluşturma sırasında yazılabilir alanlar yalnızca title ve departmentId'dir. Talebin ilk mesaj gövdesi text ile gönderilir; geçerli departmentId değerleri Destek Departmanları kaynağından alınır.

Mesajlar (include)

Bir talebin yazışma geçmişini tek istekte almak için messages ilişkisini dahil et:

support-tickets/1204?include=messages

messages ilişkisi Destek Mesajları kaynağına bağlıdır ve salt-okunurdur.

Sıralama

Sort	Anlamı
`updateTime`	Son güncelleme zamanına göre
`recordTime`	Oluşturulma zamanına göre

Varsayılan sıralama -updateTime (en son hareket görene önce).