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:

DreptApeluri pe minut
documents:write120
documents:read600
search:read60
figures:read120
exports:write10

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

CeLimită
Un fișier25 MB, refuzat înainte de citire cu 413 urn:ocost:file:too_large
Un PDF lungSe citesc doar primele pagini. pages_read spune câte.
O căutareq până la 200 de caractere, limit până la 50, offset până la 250
O cerere MCP4 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.

JSON
{
  "type": "urn:ocost:key:scope",
  "title": "Forbidden",
  "status": 403,
  "detail": "This key lacks the scope documents:write.",
  "instance": "/public/v1/files"
}
TipStareSemnificație
urn:ocost:key:invalid401Nicio cheie sau o cheie greșită, revocată ori expirată.
urn:ocost:key:scope403Cheii îi lipsește dreptul.
urn:ocost:key:rate429Prea multe apeluri. Așteptați Retry-After.
urn:ocost:file:too_large413Fișierul depășește 25 MB.
urn:ocost:file:format415Un format pe care Ocost nu îl citește.
urn:ocost:file:reading409Fișierul este în curs de citire. Ștergeți-l mai târziu.
urn:ocost:file:kept409Aceiaș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:linked409Ocost încă are nevoie de fișier. Ștergeți-l în Ocost când nimic nu mai are nevoie de el.
about:blank404Nu există un astfel de fișier sau document, ori este al altei firme.
about:blank422Câmpuri invalide, fiecare în errors[] cu loc-ul său.
about:blank503Încercați din nou în curând.

Un fișier trimis fără antetul Content-Length primește 411.

Reîncercări

RăspunsCe faceți
429, 5xxAșteptați Retry-After sau faceți pauze de 1, 2, 4 secunde și tot așa, cel mult un minut.
401Opriți-vă și anunțați o persoană. Cheia trebuie înlocuită.
Orice alt 4xxNu 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.

Vezi și