API başvurusu
Hazır işaretle
Paketin hazır olduğunu bildirir; atanmış kuryeye bildirim gider.
POST
https://kurye.firmaniz.com/api/v1/orders/{ref}/readyMutfakta paket hazır olduğunda çağırın. Kurye atanmışsa telefonuna "Sipariş hazır" bildirimi gider; sipariş henüz bekliyorsa atama hemen yeniden denenir. Kurye firması "hazır olunca ata" senaryosunu kullanıyorsa otomatik atama ancak bu çağrıdan sonra başlar. Bkz. Hazırlık süresi.
Gövde gerekmez. Zaten hazır işaretli siparişte tekrar çağırmak zararsızdır. Hazır işareti webhook olayı üretmez.
Yol parametreleri
refmetinzorunluSipariş başvurusu: sistemdeki sipariş kimliği (
1842), sipariş numarası (2611200042) ya da gönderdiğiniz kimliğin başına ext: eklenmiş hali (ext:POS-10452). Bkz. Temel kavramlar.Örnek istek
POST /orders/{ref}/ready
curl -X POST "https://kurye.firmaniz.com/api/v1/orders/ext:POS-10452/ready" \
-H "X-Api-Key: $KURYESOFT_API_KEY"Yanıt
200 Başarılı
Sipariş (hazır işaretli). Gövde bir sipariş nesnesidir.
200 · application/json
{
"id": 1842,
"code": "2611200042",
"external_id": "POS-10452",
"status": "pending",
"status_label": "Bekliyor",
"restaurant_id": 1,
"tracking_url": "https://kurye.firmaniz.com/takip/oKe9xPqrlr7b_4jbNQiNCw",
"courier": null,
"distance_m": 1754,
"eta_at": null,
"delivery_fee": 70,
"total_amount": 285.5,
"collect_amount": 285.5,
"created_at": "2026-11-20T18:10:32.000Z",
"assigned_at": null,
"picked_up_at": null,
"delivered_at": null,
"cancelled_at": null,
"cancel_reason": null
}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.
NOT_FOUNDHTTP:
404Anlamı:Sipariş ya da işletme bulunamadı. Anahtarınızın göremediği bir işletmenin siparişi de böyle görünür.
ORDER_FINALHTTP:
400Anlamı:Sipariş sonuçlanmış (teslim edildi, teslim edilemedi); değiştirilemez.
İpucu:
429 RATE_LIMITED ve 5xx yanıtlarında kısa bir beklemeyle yeniden deneyin. Bkz. Yeniden deneme.