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 :

AutorisationAppels par minute
documents:write120
documents:read600
search:read60
figures:read120
exports:write10

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

QuoiLimite
Un fichier25 Mo, refusé avant lecture avec 413 urn:ocost:file:too_large
Un long PDFSeules ses premières pages sont lues. pages_read dit combien.
Une rechercheq jusqu'à 200 caractères, limit jusqu'à 50, offset jusqu'à 250
Une requête MCP4 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"
}
TypeStatutSignification
urn:ocost:key:invalid401Aucune clé, ou une clé fausse, révoquée ou expirée.
urn:ocost:key:scope403Il manque l'autorisation à la clé.
urn:ocost:key:rate429Trop d'appels. Attendez Retry-After.
urn:ocost:file:too_large413Le fichier dépasse 25 Mo.
urn:ocost:file:format415Un format qu'Ocost ne lit pas.
urn:ocost:file:reading409Le fichier est en cours de lecture. Supprimez-le plus tard.
urn:ocost:file:kept409Les 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:linked409Ocost a encore besoin du fichier. Supprimez-le dans Ocost dès que plus rien n'en a besoin.
about:blank404Aucun fichier ou document de ce nom, ou celui d'une autre entreprise.
about:blank422Champs invalides, chacun dans errors[] avec son loc.
about:blank503Réessayez sous peu.

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

Réessayer

RéponseQue faire
429, 5xxAttendez Retry-After, ou faites une pause de 1, 2, 4 secondes et ainsi de suite, une minute au plus.
401Arrêtez et prévenez une personne. La clé doit être remplacée.
Tout autre 4xxNe 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