Limite și erori
Planul dumneavoastră
Fiecare document citit de Ocost se numără o dată în luna firmei dumneavoastră. Octeții retrimiși și căutările nu se numără. Setări › Plan și facturare arată luna de până acum. Fiecare răspuns la POST /public/v1/files spune ce a rămas în X-Ocost-Documents-Left.
La limită, Ocost stochează totuși fișierul. Răspunde not_read cu reason: "limit" și renews_on. Ocost citește fișierul singur când luna se reînnoiește sau planul crește.
Limite de rată
Fiecare cheie are o limită pe minut pentru fiecare drept:
| Drept | Apeluri pe minut |
|---|---|
documents:write | 120 |
documents:read | 600 |
search:read | 60 |
figures:read | 120 |
exports:write | 10 |
Peste o limită, Ocost răspunde 429 urn:ocost:key:rate cu Retry-After în secunde. De la o singură adresă, 30 de chei greșite pe minut primesc 401, iar mai multe primesc 429.
Toate cheile de la o adresă împart o limită exterioară: 50 de cereri pe secundă, vârfuri de până la 200 și 100 deschise simultan. Peste ea, primiți un 429 în text simplu, cu Retry-After. Trimiteți doar câteva cereri simultan și distribuiți un lot pe durata minutului său.
Dimensiuni
| Ce | Limită |
|---|---|
| Un fișier | 25 MB, refuzat înainte de citire cu 413 urn:ocost:file:too_large |
| Un PDF lung | Se citesc doar primele pagini. pages_read spune câte. |
| O căutare | q până la 200 de caractere, limit până la 50, offset până la 250 |
| O cerere MCP | 4 MB. Cheile cu documents:write pot trimite base64-ul unui fișier. Peste această limită, 413. |
Erori
Erorile sunt probleme RFC 9457 cu Content-Type: application/problem+json. Ramificați după status și type. detail este în engleză, pentru jurnalele dumneavoastră, și se poate schimba.
{
"type": "urn:ocost:key:scope",
"title": "Forbidden",
"status": 403,
"detail": "This key lacks the scope documents:write.",
"instance": "/public/v1/files"
}| Tip | Stare | Semnificație |
|---|---|---|
urn:ocost:key:invalid | 401 | Nicio cheie sau o cheie greșită, revocată ori expirată. |
urn:ocost:key:scope | 403 | Cheii îi lipsește dreptul. |
urn:ocost:key:rate | 429 | Prea multe apeluri. Așteptați Retry-After. |
urn:ocost:file:too_large | 413 | Fișierul depășește 25 MB. |
urn:ocost:file:format | 415 | Un format pe care Ocost nu îl citește. |
urn:ocost:file:reading | 409 | Fișierul este în curs de citire. Ștergeți-l mai târziu. |
urn:ocost:file:kept | 409 | Aceiași octeți sunt păstrați acolo unde cheile nu îi văd, de exemplu în încărcarea proprie a unei persoane. Nu se schimbă nimic. |
urn:ocost:file:linked | 409 | Ocost încă are nevoie de fișier. Ștergeți-l în Ocost când nimic nu mai are nevoie de el. |
about:blank | 404 | Nu există un astfel de fișier sau document, ori este al altei firme. |
about:blank | 422 | Câmpuri invalide, fiecare în errors[] cu loc-ul său. |
about:blank | 503 | Încercați din nou în curând. |
Un fișier trimis fără antetul Content-Length primește 411.
Reîncercări
| Răspuns | Ce faceți |
|---|---|
429, 5xx | Așteptați Retry-After sau faceți pauze de 1, 2, 4 secunde și tot așa, cel mult un minut. |
401 | Opriți-vă și anunțați o persoană. Cheia trebuie înlocuită. |
Orice alt 4xx | Nu trimiteți din nou aceeași cerere. |
Retrimiterea unui fișier este sigură, pentru că aceiași octeți sunt același fișier. Și ștergerea repetată este sigură și răspunde 404.
Datele dumneavoastră
Ocost rulează în UE. Originalele, citirile și indexul de căutare rămân până când ștergeți fișierul sau până când firma dumneavoastră este ștearsă. Documentele nu antrenează niciodată un model.