# Limites et erreurs
> Les documents par mois de la formule, les limites de débit, les tailles, les erreurs RFC 9457, les nouvelles tentatives, et où les données sont gardées.

## Votre formule

Chaque document qu'Ocost lit compte une fois sur le mois de votre entreprise. Les octets renvoyés et les recherches ne comptent pas. [Paramètres › Formule et facturation](https://app.ocost.io/settings/plan) montre le mois jusqu'ici. Chaque réponse à `POST /public/v1/files` dit ce qui reste dans `X-Ocost-Documents-Left`.

À la limite, Ocost stocke quand même un fichier. Il répond `not_read` avec `reason: "limit"` et `renews_on`. Ocost lit le fichier de lui-même dès que le mois se renouvelle ou que la formule augmente.

## Limites de débit

Chaque clé a une limite par minute pour chaque autorisation :

| Autorisation | Appels par minute |
| --- | --- |
| `documents:write` | 120 |
| `documents:read` | 600 |
| `search:read` | 60 |
| `figures:read` | 120 |
| `exports:write` | 10 |

Au-delà d'une limite, Ocost répond `429 urn:ocost:key:rate` avec `Retry-After` en secondes. Depuis une même adresse, 30 mauvaises clés par minute reçoivent `401`, et au-delà `429`.

Toutes les clés d'une même adresse partagent une limite externe : 50 requêtes par seconde, des pointes jusqu'à 200, et 100 ouvertes à la fois. Au-delà, un `429` en texte brut revient avec `Retry-After`. Limitez-vous à quelques requêtes simultanées, et étalez un lot sur sa minute.

## Tailles

| Quoi | Limite |
| --- | --- |
| Un fichier | 25 Mo, refusé avant lecture avec `413 urn:ocost:file:too_large` |
| Un long PDF | Seules ses premières pages sont lues. `pages_read` dit combien. |
| Une recherche | `q` jusqu'à 200 caractères, `limit` jusqu'à 50, `offset` jusqu'à 250 |
| Une requête MCP | 4 Mo. Les clés avec `documents:write` peuvent envoyer le base64 d'un fichier. Au-delà, `413`. |

## Erreurs

Les erreurs sont des problèmes RFC 9457 avec `Content-Type: application/problem+json`. Décidez selon `status` et `type`. `detail` est en anglais pour vos journaux et peut changer.

```json
{
  "type": "urn:ocost:key:scope",
  "title": "Forbidden",
  "status": 403,
  "detail": "This key lacks the scope documents:write.",
  "instance": "/public/v1/files"
}
```

| Type | Statut | Signification |
| --- | --- | --- |
| `urn:ocost:key:invalid` | 401 | Aucune clé, ou une clé fausse, révoquée ou expirée. |
| [`urn:ocost:key:scope`](https://ocost.io/docs/fr/authentication.md) | 403 | Il manque l'autorisation à la clé. |
| `urn:ocost:key:rate` | 429 | Trop d'appels. Attendez `Retry-After`. |
| `urn:ocost:file:too_large` | 413 | Le fichier dépasse 25 Mo. |
| `urn:ocost:file:format` | 415 | Un format qu'Ocost ne lit pas. |
| `urn:ocost:file:reading` | 409 | Le fichier est en cours de lecture. Supprimez-le plus tard. |
| `urn:ocost:file:kept` | 409 | Les mêmes octets sont gardés là où les clés ne les voient pas, comme l'envoi personnel d'une personne. Rien ne change. |
| `urn:ocost:file:linked` | 409 | Ocost a encore besoin du fichier. Supprimez-le dans Ocost dès que plus rien n'en a besoin. |
| `about:blank` | 404 | Aucun fichier ou document de ce nom, ou celui d'une autre entreprise. |
| `about:blank` | 422 | Champs invalides, chacun dans `errors[]` avec son `loc`. |
| `about:blank` | 503 | Réessayez sous peu. |

Un fichier envoyé sans en-tête `Content-Length` reçoit `411`.

## Réessayer

| Réponse | Que faire |
| --- | --- |
| `429`, `5xx` | Attendez `Retry-After`, ou faites une pause de 1, 2, 4 secondes et ainsi de suite, une minute au plus. |
| `401` | Arrêtez et prévenez une personne. La clé doit être remplacée. |
| Tout autre `4xx` | Ne renvoyez pas la même requête. |

Renvoyer un fichier est sans risque, car les mêmes octets sont le même fichier. Supprimer de nouveau est sans risque aussi, et répond `404`.

## Vos données

Ocost fonctionne dans l'UE. Les originaux, les lectures et l'index de recherche restent jusqu'à ce que vous supprimiez le fichier ou que votre entreprise soit supprimée. Les documents n'entraînent jamais un modèle.

## Voir aussi

- [Clés et autorisations](https://ocost.io/docs/fr/authentication.md): Les clés d'API : comment une requête en porte une, leur renouvellement, leurs autorisations et les refus.
- [Statuts et raisons](https://ocost.io/docs/fr/statuses.md): Les statuts d'un fichier et les raisons pour lesquelles il n'a pas été lu, et que faire pour chacun.
- [Envoyer un fichier et le lire](https://ocost.io/docs/fr/files.md): Envoyer un fichier, le renvoyer sans risque, attendre qu'il soit lu, lire ses documents, récupérer l'original, le supprimer.
- Sur ocost.io: [Pricing](https://ocost.io/en/pricing), [Data sovereignty](https://ocost.io/en/data-sovereignty)
