Pieprasījumu ierobežojumi un atkārtošana

1. Ierobežojumi ir uz piekļuves datiem minūtē: 120 lasījumi, 30 rakstīšanas, 10 e-rēķinu sistēmas darbības.
2. E-rēķinu sistēmas grupa aptver efactura/submit, submissions/{id}/refresh un efactura/inbox/sync.
3. Katrā atbildē ir X-RateLimit-Limit, X-RateLimit-Remaining un X-RateLimit-Reset, arī 429.
4. 429 sniedz Retry-After sekundēs; pirms atkārtošanas nogaidiet tik ilgi.

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
// Ievērojiet Retry-After; neatkārtojiet nevienu 4xx, izņemot 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;
}

// Rakstīšanas atkārtojumā JĀIZMANTO TO PAŠU Idempotency-Key, citādi izrakstīsiet
// otru fiskālo dokumentu.

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

• 10 minūtē grupa nav patvaļīga: Rumānijas ANAF atļauj aptuveni vienu ziņojumu saraksta pieprasījumu minūtē uz nodokļu maksātāja kodu (CIF).
• Atkārtojot rakstīšanu, izmantojiet TO PAŠU Idempotency-Key, citādi izrakstīsiet otru dokumentu.
• Žetona galapunktam ir atsevišķs IP ierobežojums. Saglabājiet žetonu kešatmiņā visu tā stundu ilgo derīguma laiku.
• GET /v1/me rāda pašreizējās piekļuves datu grupas — noderīgi integrācijas veselības pārbaudē.
• Vajadzīgi lielāki limiti? Rakstiet mums caur lapu Kontakti, norādot paredzamo dienas apjomu.