Limity i błędy

Twój plan

Każdy dokument odczytany przez Ocost liczy się raz do miesiąca Twojej firmy. Ponownie wysłane bajty i wyszukiwania nie liczą się wcale. Ustawienia › Plan i rozliczenia pokazuje dotychczasowy miesiąc. Każda odpowiedź na POST /public/v1/files podaje w X-Ocost-Documents-Left, ile zostało.

Po osiągnięciu limitu Ocost nadal zapisuje plik. Odpowiada not_read z reason: "limit" i renews_on. Ocost sam odczyta plik, gdy miesiąc się odnowi lub plan się powiększy.

Limity wywołań

Każdy klucz ma limit na minutę dla każdego uprawnienia:

UprawnienieWywołań na minutę
documents:write120
documents:read600
search:read60
figures:read120
exports:write10

Po przekroczeniu limitu Ocost odpowiada 429 urn:ocost:key:rate z Retry-After w sekundach. Z jednego adresu 30 błędnych kluczy na minutę dostaje 401, a kolejne dostają 429.

Wszystkie klucze z jednego adresu dzielą zewnętrzny limit: 50 żądań na sekundę, chwilowo do 200, i 100 otwartych naraz. Po jego przekroczeniu wraca 429 jako zwykły tekst z Retry-After. Wysyłaj naraz tylko kilka żądań i rozkładaj partię na całą minutę.

Rozmiary

CoLimit
Plik25 MB, odrzucany przed odczytem z 413 urn:ocost:file:too_large
Długi PDFOdczytywane są tylko jego pierwsze strony. pages_read mówi, ile.
Wyszukiwanieq do 200 znaków, limit do 50, offset do 250
Żądanie MCP4 MB. Klucze z documents:write mogą wysłać plik w base64. Powyżej 413.

Błędy

Błędy to problemy RFC 9457 z Content-Type: application/problem+json. Rozgałęziaj logikę według status i type. detail jest po angielsku, do Twoich logów, i może się zmienić.

JSON
{
  "type": "urn:ocost:key:scope",
  "title": "Forbidden",
  "status": 403,
  "detail": "This key lacks the scope documents:write.",
  "instance": "/public/v1/files"
}
TypStatusZnaczenie
urn:ocost:key:invalid401Brak klucza albo klucz błędny, unieważniony lub wygasły.
urn:ocost:key:scope403Klucz nie ma tego uprawnienia.
urn:ocost:key:rate429Za dużo wywołań. Poczekaj Retry-After.
urn:ocost:file:too_large413Plik przekracza 25 MB.
urn:ocost:file:format415Format, którego Ocost nie odczytuje.
urn:ocost:file:reading409Plik jest właśnie odczytywany. Usuń go później.
urn:ocost:file:kept409Te same bajty są przechowywane tam, gdzie klucze ich nie widzą, na przykład jako własny plik jakiejś osoby. Nic się nie zmienia.
urn:ocost:file:linked409Ocost wciąż potrzebuje pliku. Usuń go w Ocost, gdy nic go już nie potrzebuje.
about:blank404Nie ma takiego pliku ani dokumentu albo należy do innej firmy.
about:blank422Nieprawidłowe pola, każde w errors[] ze swoim loc.
about:blank503Spróbuj ponownie za chwilę.

Plik wysłany bez nagłówka Content-Length dostaje 411.

Ponawianie

OdpowiedźCo zrobić
429, 5xxPoczekaj Retry-After albo rób przerwy 1, 2, 4 sekundy i tak dalej, najwyżej minutę.
401Przerwij i powiadom człowieka. Klucz trzeba wymienić.
Każde inne 4xxNie wysyłaj ponownie tego samego żądania.

Ponowne wysłanie pliku jest bezpieczne, bo te same bajty to ten sam plik. Ponowne usunięcie też jest bezpieczne i daje 404.

Twoje dane

Ocost działa w UE. Oryginały, odczyty i indeks wyszukiwania zostają, dopóki nie usuniesz pliku lub Twoja firma nie zostanie usunięta. Dokumenty nigdy nie trenują żadnego modelu.

Zobacz też