Korlátok és kvóták
A korlátok, amelyekhez minden kérést mérünk, és a fejlécek, amelyek a kvótádat jelentik.
Kéréslimit-fejlécek
A sikeres optimalizáló hívás X-RateLimit-Limit (a FIÓK havi plafonja — a fiók összes kulcsa egyetlen kereten osztozik) és X-RateLimit-Remaining (a fiókból a hónapra hátralévő hívások száma, ezt a hívást már leszámítva) fejlécet visz. Ezeket kizárólag az optimalizáló végpontok küldik: a számláló a számítás engedélyezésének részeként foglalódik le, így a /v1/usage és a /v1/health nem tud mit jelenteni.
| Mező | Típus | Leírás |
|---|---|---|
| X-RateLimit-Limit | integer | The ACCOUNT's monthly quota, not this key's: api_authorize compares the month's calls summed over EVERY key on the account against the largest monthly_quota frozen onto any of its ACTIVE keys (migrations 049 + 053). It is the same number GET /v1/usage returns as limit. More keys do not add allowance. On an answer to the public demo key (X-CutOptim-Demo: true) it is instead the per-address DAILY demo allowance. |
| X-RateLimit-Remaining | integer | Calls left on the ACCOUNT in the current UTC calendar month AFTER this one — account-wide for the same reason X-RateLimit-Limit is. Sent only on a successful optimize: the counter is reserved as part of authorizing the request, so /v1/usage and /v1/health have nothing to report. On a demo answer: demo calls left today from this address. |
| Retry-After | integer | Sent with 402 and 409 and 429 only. 402: Seconds until the quota resets — i.e. until 00:00 UTC on the 1st of next month. 409: Sent with idempotency_in_progress: seconds to wait before retrying. 429: Seconds to wait before retrying. |
| X-CutOptim-Demo | "true" | Present, with the value true, only on an answer to the public demo key — refusals included. The demo key has no account: its 200s carry one extra warnings line saying so, and the two X-RateLimit-* headers count the per-address daily demo allowance. |
| Idempotency-Replayed | "true" | Present, with the value true, only when this answer is a stored one returned for a repeated Idempotency-Key. The body and the X-RateLimit-* values are those of the first answer. |
Korlátok
- 2,000 darab kérésenként (összes mennyiség, a qty kibontása után)
- 50 alapanyag-sor · a kéréstörzs legfeljebb 1 MB
- include "pdf": kérésenként legfeljebb 500 darab (teljes mennyiség)
- 10 aktív kulcs fiókonként — EGY havi kvótán osztoznak: a kulcsok környezeteket és integrációkat választanak szét, nem növelik a keretet
- 10 MB kérés-törzs azon a két nest-úton, amelyik rajzot hordozhat (/v1/optimize/nest és /v1/import/nest); egy source fájl legfeljebb 4 000 000 karakter, kérésenként összesen 8 000 000
- a párhuzamosság szerver-oldalon korlátozott — a számítások egyenként futnak egy rövid (kb. 8 s-os) várólista mögött; az ezen túli burst 429-et kap, és az elutasított kérés soha nem terheli a keretet. A kulcs nélküli validate végpontoknak ezen felül per-cím plafonjuk van (429 + Retry-After); működő kulccsal ez sosem throttle-öz.
Az a cím, amelyik egy percen belül 30-nál több ismeretlen API-kulcsot küld, a perc hátralevő részére 429-et kap, még a kulcs-ellenőrzés előtt. Egy fiók egyszerre 5 max jobot tarthat queued/running állapotban.
- Idempotency-Key: 8–128 karakter (A-Z a-z 0-9 _ -); a kulcsot és a tárolt választ 24 óráig őrizzük, fiókonként és kulcstípusonként (teszt vagy éles); a nyilvános demókulcs a fejlécet figyelmen kívül hagyja
- webhookok: fiókonként legfeljebb 5 végpont; 10 mp-en belül kell válaszolni, különben újrapróbáljuk — 8 próba 24 óra alatt; a kézbesítési napló 30 napig marad meg
Leállt egy motor? Az állapotoldal élőben mutatja a weboldal, az Engine API, a nesting motor és az async max motor állapotát: Szolgáltatás állapota ↗