Hizmet düzeyleri

Canlı API'yi işletirken uyduğumuz hedefler bunlardır; bizim tarafımızda, takvim ayı başına ölçülür. Veri ürünü sözleşmeleri bu hedeflere karşılık alacak (kredi) tanıyabilir; tanıdığı yerde sözleşme bunu belirtir.

Hedef	Değer	Nasıl ölçülür
`/v1` ve `/mcp` erişilebilirliği	%99,9	`5xx` ile yanıtlanmayan isteklerin payı
Okuma gecikmesi	%95'i 800 ms altında	`/v1` altındaki `GET` istekleri, bizim ağ ucumuzda (edge)
Webhook ilk denemesi	%99'u 60 sn içinde	Olayın kaydedilmesinden uç noktanıza yapılan ilk denemeye kadar
İptal	60 sn içinde	İptal edilen bir anahtar ya da belirteç her yerde çalışmayı bırakır (işlemler ve kuruluş kayıtları için hemen)
Kullanımdan kaldırma duyurusu	en az 12 ay	Bkz. sürümleme

Hedeflere karşı sayılmayanlar:

İsteğin kendisinin neden olduğu yanıtlar: hız sınırları ve kotalar için verilen 429 dahil 4xx.
Bir iş ortağı çalışmıyorken o iş ortağının koduyla (escrow_unavailable, credit_unavailable, ...) verilen 503 yanıtları. Hangi iş ortağı olduğunu ve ne zaman yeniden çalıştığını size bildiririz.
Webhook uç noktanızın başarısız olması ya da yavaş yanıt vermesi. Yeniden denemeler webhook takvimine uyar.
Henüz sunulmayan deneme ortamı; çalışmaya başladığında en iyi çaba esasıyla işletilecek.
En az 7 gün önceden duyurulan, ayda en çok 4 saat süren ve Türkiye saatiyle 06:00–22:00 dışında yapılan bakım.

Bir şeyler ters gittiğinde

API'yi etkileyen aksaklıklar, yaşandıkları sırada durum sayfasında duyurulur ve çözülene kadar en az saatte bir güncellenir.
Veri ürünü müşterilerine doğrudan, sözleşmelerindeki iletişim kişileri aracılığıyla haber verilir.
Ayın hata bütçesinin dörtte birinden fazlasını (yaklaşık 11 dakikalık tam kesinti) tüketen her aksaklık için 5 iş günü içinde bir aksaklık sonrası rapor yayımlanır.

Sizin tarafınız

5xx ve 429 yanıtlarını artan bekleme süreleri ve rastgele gecikmeyle (backoff ve jitter) yeniden deneyin. Webhook işleyicilerinizi hızlı ve idempotent tutun. X-Request-Id değerini günlüğe kaydedin: onunla, sorduğunuz her isteğin izini sürebiliriz.