Limites et erreurs
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 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.
{
"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 | 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.