# Limite și erori
> Documentele lunare ale planului, limitele de rată, dimensiunile, erorile RFC 9457, reîncercările și unde sunt păstrate datele.

## 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](https://app.ocost.io/settings/plan) 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.

```json
{
  "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`](https://ocost.io/docs/ro/authentication.md) | 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.

## Vezi și

- [Chei și drepturi](https://ocost.io/docs/ro/authentication.md): Chei API: cum le poartă o cerere, înlocuirea lor, drepturile lor și refuzurile.
- [Stări și motive](https://ocost.io/docs/ro/statuses.md): Stările unui fișier și motivele pentru care nu a fost citit, și ce faceți în fiecare caz.
- [Trimiteți și citiți un fișier](https://ocost.io/docs/ro/files.md): Trimiteți un fișier, retrimiteți-l în siguranță, așteptați până este citit, citiți-i documentele, obțineți originalul, ștergeți-l.
- Pe ocost.io: [Pricing](https://ocost.io/en/pricing), [Data sovereignty](https://ocost.io/en/data-sovereignty)
