Sık sorulan sorular

Test / sandbox ortamı var mı?

Ayrı bir sandbox ortamı yok. Tek bir üretim ortamı vardır ve oluşturduğunuz gönderi gerçek gönderidir.

Güvenli deneme yolu: POST /v1/quote ile fiyat sorgulayın — bu çağrı sipariş yaratmaz. Entegrasyonu doğrulamak için GET /v1/health ve GET /v1/orders de yan etkisizdir.

Gerçek bir sipariş oluşturup denemek isterseniz, kurye üstlenmeden önce DELETE /v1/orders/{order_no} ile iptal edebilirsiniz.

API ile ödeme alabilir miyim?

Hayır. Sipariş is_paid: false olarak oluşur. Ödeme müşteri panelinden yapılır. API'de ödeme başlatan bir uç yoktur.

Fiyatı ben belirleyebilir miyim?

Hayır. İstek gövdesinde fiyat alanı yoktur; tutar sunucuda hesaplanır ve her kayıtta yeniden doğrulanır. Tutarı önceden öğrenmek için POST /v1/quote kullanın.

Hangi bölgelere gönderi yapılıyor?

Yalnızca İstanbul içi, motosikletli kurye ile. İlçe değerleri slug biçimindedir (kadikoy, besiktas). Adalar hizmet bölgesi dışındadır.

Anahtarımı kaybettim, geri alabilir miyim?

Hayır. Anahtarın yalnızca SHA-256 özeti saklanır; ham hâli veritabanında yoktur. Panelden yeni anahtar üretip eskisini iptal edin.

Kurye tarafı uçları var mı?

Hayır. Sipariş havuzu, sipariş kabul ve teslimat adımları API'de yoktur; bunlar kurye panelinde ve mobil uygulamada yapılır.

Sürüm değişirse kodum bozulur mu?

Sürüm yola gömülüdür (/v1/…). v1 içinde kırıcı değişiklik yapılmaz; kırıcı bir değişiklik gerekirse /v2 açılır ve v1 çalışmaya devam eder. Cevaplara yeni alan eklenmesi kırıcı sayılmaz — bilmediğiniz alanları yok sayacak şekilde ayrıştırın.

Aynı siparişi iki kez oluşturmayı nasıl önlerim?

Şu anda idempotency anahtarı desteği yoktur. Ağ hatası sonrası tekrar denemeden önce GET /v1/orders ile son siparişlerinizi kontrol edin.