Limites de débit et retries

1. Les limites s’appliquent par identifiant et par minute : 120 lectures, 30 écritures, 10 opérations de facturation électronique.
2. Le quota de facturation électronique couvre efactura/submit, submissions/{id}/refresh et efactura/inbox/sync.
3. Chaque réponse contient X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset, y compris la 429.
4. Une 429 vous fournit Retry-After en secondes ; attendez ce délai avant de réessayer.

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
// Respectez Retry-After ; ne retentez jamais un 4xx autre que 429.
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;
}

// Une nouvelle tentative d'écriture DOIT réutiliser le MÊME Idempotency-Key, sinon vous émettez
// un second document fiscal.

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

• Le quota de 10 par minute n’est pas arbitraire : en Roumanie, ANAF autorise elle-même environ un appel de liste de messages par minute et par CIF.
• Lorsque vous relancez une écriture, réutilisez la MÊME Idempotency-Key, sinon vous émettez un second document.
• L’endpoint de jeton a une limite séparée par IP. Mettez le jeton en cache pendant toute sa durée de vie d’une heure.
• GET /v1/me affiche les quotas actuels de l’identifiant — utile dans un health check de l’intégration.
• Écrivez-nous via la page de contact en indiquant votre volume journalier prévu.