120 lestrar, 30 skrif og 10 aðgerðir í landskerfinu á mínútu á hvert skilríki, með X-RateLimit-*-hausum.
Fyrsti reikningurinn þinn í 6 skrefum
- Mörkin eru á hvert skilríki, á mínútu: 120 lestrar, 30 skrif, 10 aðgerðir í landskerfinu.
- Fatan fyrir landskerfið nær yfir efactura/submit, submissions/{id}/refresh og efactura/inbox/sync.
- Hvert svar ber X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Reset, líka 429.
- 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útu | Merking |
|---|---|---|
| read | 120 | GET *, POST /invoices/preview-totals, POST /invoices/{id}/efactura/validate |
| write | 30 | POST /invoices, POST /invoices/{id}/storno, POST|DELETE /invoices/{id}/payments, POST /clients |
| submit | 10 | POST /invoices/{id}/efactura/submit, POST /efactura/submissions/{id}/refresh, POST /efactura/inbox/sync |
Villur
| Staða | Tegund | Kóði |
|---|---|---|
| 429 | rate_limit_error | rate_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.