Uçlar

Taban adres https://api.enyakinkurye.com. Aşağıdaki altı uç dışında bir uç yoktur.

GET/v1/health

Servis durumu. Anahtar gerektirmez, veri döndürmez.

{
  "status": "ok",
  "service": "enyakinkurye-api",
  "version": "v1",
  "time": "2026-08-17T18:00:00.000Z"
}

POST/v1/quote

Sipariş oluşturmadan fiyat sorar. Sipariş yaratmaz.

İstek alanları

Alan	Tip	Zorunlu	Açıklama
`weight_tier`	string	evet	`0-5`, `5-10`, `10-15` veya `15-20` (kg)
`pickup_lat`	number	evet	Alım noktası enlemi, örn. `41.0082`
`pickup_lng`	number	evet	Alım noktası boylamı, örn. `28.9784`
`delivery_lat`	number	evet	Teslim noktası enlemi
`delivery_lng`	number	evet	Teslim noktası boylamı
`is_urgent`	boolean	hayır	Acil öncelik
`crossings`	string[]	hayır	`avrasya`, `fsm`, `yss`, `15-temmuz`
`stops`	object[]	hayır	Ek teslimat noktaları; teklif için yalnızca `lat`/`lng` gerekir. Mesafe bu noktalardan geçerek hesaplanır.
`extra_stops`	integer	hayır	Tek başına kullanılmaz. Adet `stops` listesinden türetilir.

Cevap

{
  "currency": "TRY",
  "delivery_fee": 210.83,
  "distance_km": 17.7,
  "distance_fee": 220.50,
  "urgent_fee": 0,
  "extra_stop_fee": 0,
  "crossing_fee": 0,
  "total": 431.33
}

POST/v1/orders

Gönderi oluşturur. Başarıda 201 döner.

İstek alanları

Alan	Tip	Zorunlu	Açıklama
`pickup_district`	string	evet	İlçe slug'ı, örn. `kadikoy`
`pickup_address`	string	evet	Açık alım adresi
`delivery_district`	string	evet	İlçe slug'ı
`delivery_address`	string	evet	Açık teslim adresi
`pickup_lat`	number	evet	Alım noktası enlemi, örn. `41.0082`
`pickup_lng`	number	evet	Alım noktası boylamı, örn. `28.9784`
`delivery_lat`	number	evet	Teslim noktası enlemi
`delivery_lng`	number	evet	Teslim noktası boylamı
`weight_tier`	string	evet	`0-5`, `5-10`, `10-15` veya `15-20` (kg)
`recipient_name`	string	hayır	Alıcı adı
`recipient_phone`	string	hayır	Alıcı telefonu
`courier_note`	string	hayır	Kuryeye not
`is_urgent`	boolean	hayır	Acil öncelik
`crossings`	string[]	hayır	Köprü/tünel seçimi
`stops`	object[]	hayır	Ek teslimat noktaları. Her biri `address`, `lat`, `lng` zorunlu; `district`, `recipient_name`, `recipient_phone` isteğe bağlı. Mesafe bu noktalardan geçerek hesaplanır.
`extra_stops`	integer	hayır	Tek başına kullanılmaz. Adet `stops` listesinden türetilir; adres olmadan yalnızca sayı göndermek `400 durak_adresi_eksik` ile reddedilir.
`payment_method`	string	hayır	`wallet` (varsayılan), `credit_card`, `cash`
`declared_value`	number	hayır	Gönderi değeri beyanı

Fiyat alanı yoktur. Tutarı gönderemezsiniz; sunucu hesaplar. Gönderilen herhangi bir tutar yok sayılır.

Mesafe ücreti koordinatlardan hesaplanır. Kuş uçuşu değil, gerçek sürüş rotası kullanılır ve rotayı sunucu çeker — mesafeyi de siz gönderemezsiniz. Bu yüzden koordinatlar zorunludur: onlarsız yol mesafesi bilinemez. /v1/quote ile /v1/orders aynı mesafeyi aynı tarifeden geçirir, yani teklif ile tahsil edilen tutar birbirini tutar.

Rota servisi yanıt vermezse sipariş kurulmaz: 502 mesafe_hesaplanamadi döner. Kısa bir mesafeyle ücretlendirmek yerine isteği reddetmeyi tercih ediyoruz.

Ek teslimat noktaları mesafeye dahildir. Rota alım → ana teslimat → stops[0] → stops[1] … sırasıyla hesaplanır; sıra optimize edilmez, gönderdiğiniz sırayla sürülür. Bu yüzden her durak için koordinat zorunludur: koordinatsız bir durak rotaya giremez ve mesafe olduğundan kısa çıkardı. Durak başına ayrıca sabit bir ek nokta ücreti alınır.

declared_value bir beyandır, bedel değildir. Ücretsiz kapsamı aşan kısım için gönderi güvencesi bedeli sunucuda hesaplanır ve cevapta assurance_fee olarak ayrı bir kalem hâlinde döner. Üst sınırı aşan beyan 422 declared_value_too_high ile reddedilir.

cash yalnızca ilk üç siparişini kartla tamamlamış hesaplarda kabul edilir; aksi hâlde 422 cash_not_available döner.

Cevap

{
  "order_no": "#000042",
  "status": "waiting",
  "total": 133.65,
  "currency": "TRY",
  "is_paid": false,
  "payment_method": "wallet",
  "declared_value": 0,
  "assurance_fee": 0,
  "pickup_district": "kadikoy",
  "delivery_district": "uskudar",
  "created_at": "2026-08-17T18:00:00.000Z"
}

GET/v1/orders

Hesabınıza ait gönderileri en yeniden eskiye listeler.

Sorgu parametreleri

Parametre	Varsayılan	Açıklama
`limit`	50	En fazla 100
`offset`	0	Sayfalama
`status`	—	`waiting`, `active`, `delivering`, `done`, `cancelled`

{ "data": [ { "order_no": "#000042", "status": "waiting", ... } ] }

GET/v1/orders/{order_no}

Tek gönderinin ayrıntısı. Numara #000042, 000042 ve 42 biçimlerinin üçünü de kabul eder.

{
  "order_no": "#000042",
  "status": "active",
  "total": 133.65,
  "currency": "TRY",
  "is_paid": false,
  "payment_method": "wallet",
  "pickup_district": "kadikoy",
  "pickup_address": "Caferaga Mah. ...",
  "delivery_district": "uskudar",
  "delivery_address": "Mimar Sinan Mah. ...",
  "recipient_name": "Ayse Yilmaz",
  "is_urgent": false,
  "created_at": "2026-08-17T18:00:00.000Z",
  "picked_up_at": "2026-08-17T18:22:00.000Z",
  "delivered_at": null,
  "cancelled_at": null
}

DELETE/v1/orders/{order_no}

Gönderiyi iptal eder. Yalnızca kurye atanmamış, bekleyen gönderi iptal edilebilir; kurye üstlendikten sonra 409 order_not_cancellable döner.

{ "cancelled": true, "order_no": "#000042" }

Sipariş durumları

Durum	Anlamı
`waiting`	Havuzda, kurye bekliyor
`active`	Kurye üstlendi
`delivering`	Gönderi yolda
`done`	Teslim edildi
`cancelled`	İptal edildi

Hata cevaplarının biçimi için Hata kodları sayfasına bakın.