İçeriğe geç
KuryeSoft

API başvurusu

İptal sebeplerini listele

Kurye firmasının tanımladığı hazır iptal sebepleri.
GEThttps://kurye.firmaniz.com/api/v1/cancel-reasons

Sipariş iptalinde sebep serbest metindir; raporlarda aynı sebepler bir arada görünsün diye kullanıcınıza bu listeden seçtirmeniz önerilir. Seçilen sebebin name değerini Siparişi iptal et çağrısında reason olarak gönderin.

Örnek istek

curl "https://kurye.firmaniz.com/api/v1/cancel-reasons" \
  -H "X-Api-Key: $KURYESOFT_API_KEY"

Yanıt

200 Başarılı

Etkin iptal sebepleri.

itemsnesne dizisi
Sebepler.
items[].idtam sayı
Sebep kimliği.
items[].namemetin
Sebep metni.
200 · application/json
{
  "items": [
    {
      "id": 1,
      "name": "Müşteri vazgeçti"
    },
    {
      "id": 2,
      "name": "Yanlış sipariş girildi"
    },
    {
      "id": 3,
      "name": "Ürün kalmadı"
    },
    {
      "id": 6,
      "name": "Diğer"
    }
  ]
}

Hatalar

Hata gövdesi her zaman { "error": { "code", "message", "fields" } } biçimindedir. Bu uçta karşılaşabileceğiniz kodlar (bütün liste için Hatalar):

API_KEY_REQUIRED
HTTP:401
Anlamı:İstekte API anahtarı yok ya da ks_ ile başlamıyor.
API_KEY_INVALID
HTTP:401
Anlamı:Anahtar yanlış, silinmiş ya da pasif.
İpucu:

429 RATE_LIMITED ve 5xx yanıtlarında kısa bir beklemeyle yeniden deneyin. Bkz. Yeniden deneme.