Užklausų limitai ir pakartojimai

1. Limitai taikomi prieigos duomenims per minutę: 120 skaitymų, 30 rašymų, 10 e. sąskaitų faktūrų sistemos operacijų.
2. E. sąskaitų faktūrų sistemos grupė apima efactura/submit, submissions/{id}/refresh ir efactura/inbox/sync.
3. Kiekvienas atsakymas turi X-RateLimit-Limit, X-RateLimit-Remaining ir X-RateLimit-Reset, įskaitant 429.
4. 429 pateikia Retry-After sekundėmis; prieš bandydami dar kartą palaukite tiek.

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
// Laikykitės Retry-After; nekartokite jokios 4xx klaidos, išskyrus 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;
}

// Kartojant rašymą PRIVALU naudoti TĄ PATĮ Idempotency-Key, kitaip išrašysite
// antrą fiskalinį dokumentą.

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

• 10 per minutę grupė nėra savavališka: Rumunijos ANAF leidžia maždaug vieną žinučių sąrašo užklausą per minutę vienam mokesčių mokėtojo kodui (CIF).
• Kartodami rašymą naudokite TĄ PATĮ Idempotency-Key, kitaip išrašysite antrą dokumentą.
• Žetono galiniam taškui taikomas atskiras IP limitas. Įsiminkite žetoną visam vienos valandos galiojimui.
• GET /v1/me rodo dabartines prieigos duomenų grupes — naudinga integracijos sveikatos patikrinime.
• Reikia didesnių ribų? Rašykite mums per Kontaktai puslapį, nurodydami numatomą dienos apimtį.