İstek Kuralları
Gövde biçimleri, Idempotency-Key, dry_run, kısmi başarı, sayfalama ve sürümleme.
Son güncelleme: 21 Eylül 2026 · Sözleşme sürümü 1.0.0
Tüm uçlar için geçerli genel kurallar. Kimlik doğrulama ve ortamlar kendi sayfalarında anlatılır.
Gövde ve biçimler
JSON, UTF-8. Tutarlar 2 ondalık haneli string ("12500.00"; ekstrede işaretli: borç +, alacak −). Tarihler YYYY-MM-DD, zaman damgaları ISO 8601 (UTC). Alan adları snake_case. Şemada olmayan bir alan gönderirseniz 400 alırsınız (strict); yanıtta bilmediğiniz alanı yok sayın.
Idempotency-Key
Yazma isteklerinde Idempotency-Key başlığı (UUID önerilir). Aynı anahtar + aynı gövde 24 saat boyunca aynı yanıtı döner (Idempotency-Replayed: true), aynı anahtar farklı gövde 409. Talep teslimatında (complete) zorunludur; dry_run=true çağrısında istenmez.
dry_run
Yazma uçlarına (complete, exports) ?dry_run=true ekleyin: hiçbir şey yazılmaz; doğrulama sonucu ve "ne olacak" raporu döner. Kota ve kayıt yazılmaz; yalnız hız sınırı sayacı işler.
Kısmi başarı
Cari listesi teslimatında (complete { counterparties }) yanıt 207 yerine 200 + delivery { accepted, rejected, errors[] } döner; kabul edilenler yazılır, reddedilenler index ile listelenir. Ekstre ve bakiye teslimatı ya bütünüyle kabul edilir ya da 422 ile reddedilir.
Sayfalama
Listeler imleçlidir: yanıttaki next_cursor değerini bir sonraki isteğe ?cursor= olarak verin; null gelince liste bitmiştir. updated_since ile yalnız değişenleri çekebilirsiniz (imleç updated_at, id sırasına göredir).
Hız sınırı
Anahtar başına dakikada 300 istek; aşımda 429 + Retry-After. Talep yoklaması (GET /erp-requests) anahtar başına dakikada 12 çağrı; teslimat (complete) anahtar başına tek eşzamanlı analiz.
Sürüm ve geriye uyumluluk
Sürüm yolda (/api/v1). Yeni alanlar eklenebilir (istemci yok saymalı); alan/uç kaldırılmadan en az 12 ay önce değişiklik günlüğünde duyurulur ve Deprecation başlığıyla işaretlenir.