Ліміти запитів і повторні спроби

1. Ліміти діють на набір облікових даних, за хвилину: 120 читань, 30 записів, 10 операцій з національною системою електронного виставлення рахунків.
2. Кошик для національної системи електронного виставлення рахунків охоплює efactura/submit, submissions/{id}/refresh і efactura/inbox/sync.
3. Кожна відповідь містить X-RateLimit-Limit, X-RateLimit-Remaining і X-RateLimit-Reset, включно з 429.
4. 429 повертає Retry-After у секундах; зачекайте стільки, перш ніж повторювати.

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; ніколи не повторюйте 4xx, крім 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;
}

// Повторна спроба запису МАЄ використати ТОЙ САМИЙ Idempotency-Key, інакше ви виставите
// другий фіскальний документ.

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

• Кошик 10 на хвилину не довільний: у Румунії ANAF дозволяє приблизно один виклик списку повідомлень на хвилину для одного CIF.
• Повторюючи запис, використовуйте ТОЙ САМИЙ Idempotency-Key, інакше ви випустите другий документ.
• Токен ендпоінт має окремий ліміт на IP. Кешуйте токен на весь його годинний строк дії.
• GET /v1/me показує поточні кошики облікових даних — корисно для перевірки справності інтеграції.
• Потрібні вищі стелі? Напишіть нам через сторінку Контакти, вказавши очікуваний добовий обсяг.