Kutsurajoitukset ja uudelleenyritykset

1. Rajat ovat tunnuskohtaisesti minuutissa: 120 lukua, 30 kirjoitusta, 10 sähkölaskujärjestelmän operaatiota.
2. Sähkölaskujärjestelmän ryhmä kattaa efactura/submit-, submissions/{id}/refresh- ja efactura/inbox/sync-kutsut.
3. Jokainen vastaus sisältää X-RateLimit-Limit, X-RateLimit-Remaining ja X-RateLimit-Reset, myös 429-vastauksen.
4. 429-vastaus antaa Retry-After-arvon sekunteina; odota se ennen uutta yritystä.

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
// Noudata Retry-After-arvoa; älä yritä uudelleen mitään 4xx-virhettä paitsi 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;
}

// Kirjoituksen uudelleenyrityksessä on käytettävä SAMAA Idempotency-Keytä, muuten myönnät
// toisen verotuksellisen asiakirjan.

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

• 10 kutsua minuutissa -ryhmä ei ole mielivaltainen: Romanian ANAF sallii noin yhden viestilistauskutsun minuutissa verotunnistetta (CIF) kohden.
• Kun yrität kirjoitusta uudelleen, käytä SAMAA Idempotency-Keytä, muuten luot toisen asiakirjan.
• Tokenin päätepisteellä on erillinen IP-kohtainen raja. Välimuistita token koko yhden tunnin elinkaaren ajan.
• GET /v1/me näyttää tunnuksen nykyiset ryhmät — hyödyllinen integraation terveystarkistuksessa.
• Tarvitsetko korkeampia rajoja? Kirjoita meille Yhteydenotto-sivun kautta ja ilmoita odotettu päiväkohtainen volyymi.