Hraðamörk og endurtekningar

120 lestrar, 30 skrif og 10 aðgerðir í landskerfinu á mínútu á hvert skilríki, með X-RateLimit-*-hausum.

120 lestrar, 30 skrif og 10 aðgerðir í landskerfinu á mínútu á hvert skilríki, með X-RateLimit-*-hausum.

← Til baka í API-skjölin

Fyrsti reikningurinn þinn í 6 skrefum

  1. Mörkin eru á hvert skilríki, á mínútu: 120 lestrar, 30 skrif, 10 aðgerðir í landskerfinu.
  2. Fatan fyrir landskerfið nær yfir efactura/submit, submissions/{id}/refresh og efactura/inbox/sync.
  3. Hvert svar ber X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Reset, líka 429.
  4. 429 gefur þér Retry-After í sekúndum; bíddu þann tíma áður en þú reynir aftur.

Hvað eru forritaskil 4invoices

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
// Virtu Retry-After; endurreyndu aldrei 4xx nema 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;
}

// Endurtekning skrifs VERÐUR að nota SAMA Idempotency-Key, annars gefurðu út
// annað fjárhagsskjal.

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

Hraðamörk

Fata (bucket)Beiðnir / mínútuMerking
read120GET *, POST /invoices/preview-totals, POST /invoices/{id}/efactura/validate
write30POST /invoices, POST /invoices/{id}/storno, POST|DELETE /invoices/{id}/payments, POST /clients
submit10POST /invoices/{id}/efactura/submit, POST /efactura/submissions/{id}/refresh, POST /efactura/inbox/sync

Villur

StaðaTegundKóði
429rate_limit_errorrate_limit_exceeded

Algeng mistök

  • 10-á-mínútu fatan er ekki handahófskennd: í Rúmeníu leyfir ANAF sjálft u.þ.b. eitt kall á skilaboðalista á mínútu á hvert CIF.
  • Þegar þú endurreynir skrif skaltu nota SAMA Idempotency-Key, annars gefurðu út annað skjal.
  • Tókenaendapunkturinn hefur sérstök mörk á hverja IP-tölu. Geymdu tókenið í skyndiminni allan eins klukkustundar líftíma þess.
  • GET /v1/me sýnir núverandi fötur skilríkisins — gagnlegt í heilsuathugun samþættingar.
  • Þarftu hærri þök? Skrifaðu okkur í gegnum síðuna Hafa samband með væntanlegu daglegu magni.

Spurningar og svör fyrir þróendur

Er mörkin á reikning eða á skilríki?

Á skilríki. Með því að skipta umferð á skilríki fyrir hvert kerfi getur stór innflutningur ekki svelt lifandi flæði vefverslunarinnar þinnar.

Hvaða bið mælið þið með?

Virtu Retry-After þegar það er til staðar, annars veldisvaxandi frá 1–2 sekúndum með mest 5 tilraunum. Engar þéttar lúppur.

Ber 429 líka X-RateLimit-hausana?

Já. Við sendum þá með 429 sjálfu, og þar þarf viðskiptavinurinn þá til að reikna út biðina.