API başvurusu
İptal sebeplerini listele
Kurye firmasının tanımladığı hazır iptal sebepleri.
GET
https://kurye.firmaniz.com/api/v1/cancel-reasonsSipariş 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
GET /cancel-reasons
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 dizisiSebepler.
items[].idtam sayıSebep kimliği.
items[].namemetinSebep 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):
Kod
HTTP
Anlamı
API_KEY_REQUIREDHTTP:
401Anlamı:İstekte API anahtarı yok ya da
ks_ ile başlamıyor.API_KEY_INVALIDHTTP:
401Anlamı:Anahtar yanlış, silinmiş ya da pasif.
İpucu:
429 RATE_LIMITED ve 5xx yanıtlarında kısa bir beklemeyle yeniden deneyin. Bkz. Yeniden deneme.