Grenzen und Fehler

Ihr Tarif

Jeder gelesene Beleg zählt einmal im Monat Ihres Unternehmens (Einstellungen › Tarif); erneut geschickte Bytes und Suchen zählen nicht. X-Ocost-Documents-Left an jeder Antwort von POST /public/v1/files sagt, was übrig ist.

An der Grenze wird eine Datei trotzdem gespeichert, als not_read mit reason: "limit" und renews_on, und von selbst gelesen, sobald sich der Monat erneuert oder der Tarif wächst.

Ratenlimits

Je Schlüssel und Minute	Grenze
`documents:write` (schicken, löschen)	120 Aufrufe
`documents:read` (Dateien, Belege, Bytes, Liste)	600 Aufrufe
`search:read`	60 Suchen

Darüber: 429 urn:ocost:key:rate mit Retry-After in Sekunden. Von einer Adresse bekommen 30 falsche Schlüssel je Minute 401, weitere 429.

Je Adresse, alle Schlüssel zusammen: 50 Anfragen je Sekunde (kurz bis 200), 100 gleichzeitig offen; darüber ein 429 als Text mit Retry-After. Verteilen Sie einen Stapel über seine Minute.

Größen

Eine Datei: bis 25 MB, abgelehnt, bevor sie gelesen wird (413 urn:ocost:file:too_large).
Ein langes PDF: Nur die ersten Seiten werden gelesen; pages_read sagt, wie viele.
Eine Suche: q bis 200 Zeichen, limit bis 50, offset bis 250.

Fehler

RFC-9457-Problems, Content-Type: application/problem+json. Verzweigen Sie nach status und type; detail ist Englisch für Ihre Logs und kann sich ändern.

JSON

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

Typ	Status	Bedeutung
`urn:ocost:key:invalid`	401	Kein Schlüssel oder ein falscher, widerrufener oder abgelaufener.
`urn:ocost:key:scope`	403	Dem Schlüssel fehlt die Berechtigung.
`urn:ocost:key:rate`	429	Zu viele Aufrufe; warten Sie `Retry-After`.
`urn:ocost:file:too_large`	413	Über 25 MB.
`urn:ocost:file:format`	415	Ein Format, das Ocost nicht liest.
`urn:ocost:file:reading`	409	Wird gerade gelesen; später löschen.
`urn:ocost:file:kept`	409	Dieselben Bytes liegen dort, wo der Schlüssel sie nicht sieht.
`urn:ocost:file:linked`	409	Ocost braucht sie noch (bezahlt, abgeglichen, gebucht, eine offene Frage, die eines Projekts); löschen Sie sie in Ocost, sobald nichts sie mehr braucht.
`about:blank`	404	Keine solche Datei, kein solcher Beleg, oder der eines anderen Unternehmens.
`about:blank`	422	Ungültige Felder, jedes in `errors[]` mit seinem `loc`.
`about:blank`	503	Gleich noch einmal versuchen.

Wiederholen

429, 5xx: nach Retry-After oder mit wachsenden Pausen (1, 2, 4, … Sekunden, höchstens eine Minute).
Eine Datei erneut zu schicken ist sicher: Dieselben Bytes sind dieselbe Datei. Erneutes Löschen auch (404).
401: aufhören und einem Menschen Bescheid geben; der Schlüssel muss ersetzt werden.
Andere 4xx: nicht unverändert wiederholen.

Daten

Ocost läuft in der EU. Originale, das Gelesene und der Suchindex bleiben, bis Sie die Datei löschen (DELETE /public/v1/files/{file_id}) oder Ihr Unternehmen gelöscht wird. Belege trainieren nie ein Modell.