Hastighetsgrenser og nye forsøk

1. Grensene gjelder per legitimasjon, per minutt: 120 lesinger, 30 skrivinger, 10 operasjoner mot det nasjonale e-fakturasystemet.
2. Kvoten for det nasjonale e-fakturasystemet dekker efactura/submit, submissions/{id}/refresh og efactura/inbox/sync.
3. Hvert svar har X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Reset, også 429.
4. En 429 gir deg Retry-After i sekunder; vent så lenge før du prøver igjen.

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
// Respekter Retry-After; prøv aldri igjen ved en 4xx annet enn 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;
}

// Et nytt forsøk på en skrivning MÅ bruke SAMME Idempotency-Key, ellers utsteder du
// et nytt fiskalt dokument.

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

• Kvoten på 10 per minutt er ikke vilkårlig: ANAF i Romania tillater selv omtrent ett kall til meldingslisten per minutt per CIF.
• Ved nytt forsøk av en skrivning, bruk SAMME Idempotency-Key, ellers utsteder du et nytt dokument.
• Token-endepunktet har en egen grense per IP. Cache tokenet i hele levetiden på én time.
• GET /v1/me viser legitimasjonens gjeldende kvoter — nyttig i en helsesjekk av integrasjonen.
• Trenger du høyere tak? Skriv til oss via kontaktsiden med forventet daglig volum.