REST API v1 · OpenAPI 3.1
Geliştirici Dokümantasyonu
Kimlik Doğrulama & Kota Başlıkları
Tüm /v1/* uçları Authorization: Bearer kk_live_... veya X-Api-Key başlığı bekler.
Anahtar başına dakikada 60 istek sınırı uygulanır.
- X-RateLimit-Limit / X-RateLimit-Remaining
- Dakikalık istek limiti (60) ve kalan hakkınız.
- X-Quota-Limit / X-Quota-Remaining
- Aylık plan kotanız ve kalan takip sorgusu hakkınız.
GET
/v1/detect/{takip_no}
Kotadan düşmez
Takip numarasının formatına uyan kargo firmalarını listeler.
curl -H "Authorization: Bearer kk_live_ornek" https://kargokonum.com/v1/detect/7301234567
GET
/v1/track/{takip_no}?carrier={slug}
1 kota harcar
Gönderinin durumunu, KVKK maskeli alıcı/gönderici bilgisini, şubesini ve hareket geçmişini döndürür.
curl -H "Authorization: Bearer kk_live_ornek" "https://kargokonum.com/v1/track/7301234567?carrier=yurtici"
GET
/v1/branches?carrier=yurtici&city=İstanbul
Kotadan düşmez
Firma, il, ilçe veya anahtar kelimeye göre şube adres, telefon ve koordinat listesini döndürür.