# Betakurye Delivery API v1

> POS, adisyon ve sipariş yazılımlarının Betakurye kurye ağına sipariş göndermesi için REST API. OAuth 2.0 client_credentials (30 dk jeton), JSON, Standard Webhooks imzalı olaylar (HMAC-SHA256). Belge Türkçe.

Temel kurallar: POST /v1/deliveries için Idempotency-Key başlığı zorunlu; zamanlar saat dilimli ISO 8601; para TL iki ondalık; alanlar snake_case; paket kuryeye verildikten sonra iptal/değişiklik 409 KURYE_ALDI.

Ek kurallar: konum yoksa dropoff.lat/lng göndermeyin (0,0 ve Türkiye dışı yok sayılır); hizmet alanı dışı adres 422 HIZMET_DISI; zaman aşımından sonra GET /v1/deliveries?external_ref=… ile sorun; platform siparişinde customer.phone = çağrı merkezi, customer.phone_extension = arama kodu; test: true siparişi kuryeye düşürmez; items[].quantity ondalık olabilir; yanıtta fee, distance_m, road_km; hız sınırı entegratör başına dakikada 1.200.

## Başlarken

- [Genel bakış](https://betakurye.com/gelistirici)
- [Hızlı başlangıç](https://betakurye.com/gelistirici/hizli-baslangic)
- [Deneme ortamı](https://betakurye.com/gelistirici/deneme-ortami)
- [Kimlik doğrulama](https://betakurye.com/gelistirici/kimlik-dogrulama)

## Kavramlar

- [Sipariş yolculuğu](https://betakurye.com/gelistirici/siparis-akisi)
- [Webhook](https://betakurye.com/gelistirici/webhook)
- [Ödeme tipleri](https://betakurye.com/gelistirici/odeme-tipleri)

## Başvuru

- [Uçlar](https://betakurye.com/gelistirici/uclar)
- [Hatalar ve sınırlar](https://betakurye.com/gelistirici/hatalar)

## Canlıya geçiş

- [En iyi uygulamalar](https://betakurye.com/gelistirici/en-iyi-uygulamalar)
- [Canlıya geçiş listesi](https://betakurye.com/gelistirici/canliya-gecis)
- [Sürüm geçmişi](https://betakurye.com/gelistirici/surumler)

## Makine okunur

- [OpenAPI (Swagger) JSON](https://betakurye.com/docs/json)
- [Postman koleksiyonu](https://betakurye.com/gelistirici/postman.json)