İstek limitleri ve yeniden denemeler

1. Sınırlar kimlik bilgisi başına, dakika başınadır: 120 okuma, 30 yazma, 10 ulusal e-fatura sistemi işlemi.
2. Ulusal e-fatura sistemi kovası efactura/submit, submissions/{id}/refresh ve efactura/inbox/sync işlemlerini kapsar.
3. 429 dahil her yanıt X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset taşır.
4. 429 size saniye cinsinden Retry-After verir; yeniden denemeden önce o kadar bekleyin.

http
HTTP/2 429
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1785312000
Retry-After: 17
Content-Type: application/json

{"error":{"type":"rate_limit_error","code":"rate_limit_exceeded",
 "message":"...","doc_url":"https://4invoices.net/ro/api-dezvoltatori#errors",
 "request_id":"req_..."}}

javascript
// Retry-After'a uyun; 429 dışındaki 4xx hatalarını asla yeniden denemeyin.
async function call(url, init, attempt = 0) {
  const res = await fetch(url, init);
  if (res.status === 429 || res.status >= 500) {
    if (attempt >= 5) return res;
    const retryAfter = Number(res.headers.get("Retry-After")) || 2 ** attempt;
    await new Promise((r) => setTimeout(r, retryAfter * 1000));
    return call(url, init, attempt + 1);
  }
  return res;
}

// Bir yazma yeniden denemesi AYNI Idempotency-Key'i kullanmak ZORUNDADIR, aksi hâlde
// ikinci bir mali belge kesersiniz.

https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json

• Dakikada 10’luk kova keyfî değildir: Romanya’da ANAF, CIF başına dakikada yaklaşık bir mesaj listesi çağrısına izin verir.
• Bir yazma işlemini yeniden denerken AYNI Idempotency-Key’i kullanın, aksi takdirde ikinci bir belge düzenlersiniz.
• Token endpoint’inin IP başına ayrı bir sınırı vardır. Token’ı bir saatlik ömrünün tamamı boyunca önbellekte tutun.
• GET /v1/me kimlik bilgisinin güncel kovalarını gösterir — bir entegrasyon sağlık kontrolünde kullanışlıdır.
• Daha yüksek tavanlara mı ihtiyacınız var? Beklenen günlük hacminizle birlikte İletişim sayfası üzerinden bize yazın.