# Limity i błędy
> Dokumenty planu na miesiąc, limity wywołań, rozmiary, błędy RFC 9457, ponawianie i miejsce przechowywania danych.

## 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](https://app.ocost.io/settings/plan) 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:

| Uprawnienie | Wywołań na minutę |
| --- | --- |
| `documents:write` | 120 |
| `documents:read` | 600 |
| `search:read` | 60 |
| `figures:read` | 120 |
| `exports:write` | 10 |

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

| Co | Limit |
| --- | --- |
| Plik | 25 MB, odrzucany przed odczytem z `413 urn:ocost:file:too_large` |
| Długi PDF | Odczytywane są tylko jego pierwsze strony. `pages_read` mówi, ile. |
| Wyszukiwanie | `q` do 200 znaków, `limit` do 50, `offset` do 250 |
| Żądanie MCP | 4 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"
}
```

| Typ | Status | Znaczenie |
| --- | --- | --- |
| `urn:ocost:key:invalid` | 401 | Brak klucza albo klucz błędny, unieważniony lub wygasły. |
| [`urn:ocost:key:scope`](https://ocost.io/docs/pl/authentication.md) | 403 | Klucz nie ma tego uprawnienia. |
| `urn:ocost:key:rate` | 429 | Za dużo wywołań. Poczekaj `Retry-After`. |
| `urn:ocost:file:too_large` | 413 | Plik przekracza 25 MB. |
| `urn:ocost:file:format` | 415 | Format, którego Ocost nie odczytuje. |
| `urn:ocost:file:reading` | 409 | Plik jest właśnie odczytywany. Usuń go później. |
| `urn:ocost:file:kept` | 409 | Te 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:linked` | 409 | Ocost wciąż potrzebuje pliku. Usuń go w Ocost, gdy nic go już nie potrzebuje. |
| `about:blank` | 404 | Nie ma takiego pliku ani dokumentu albo należy do innej firmy. |
| `about:blank` | 422 | Nieprawidłowe pola, każde w `errors[]` ze swoim `loc`. |
| `about:blank` | 503 | Spróbuj ponownie za chwilę. |

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

## Ponawianie

| Odpowiedź | Co zrobić |
| --- | --- |
| `429`, `5xx` | Poczekaj `Retry-After` albo rób przerwy 1, 2, 4 sekundy i tak dalej, najwyżej minutę. |
| `401` | Przerwij i powiadom człowieka. Klucz trzeba wymienić. |
| Każde inne `4xx` | Nie 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ż

- [Klucze i uprawnienia](https://ocost.io/docs/pl/authentication.md): Klucze API: jak niesie je żądanie, ich wymiana, ich uprawnienia i odmowy.
- [Statusy i powody](https://ocost.io/docs/pl/statuses.md): Statusy pliku i powody, dla których nie został odczytany, oraz co zrobić w każdym przypadku.
- [Wysłać plik i go odczytać](https://ocost.io/docs/pl/files.md): Wysłać plik, bezpiecznie wysłać go ponownie, poczekać, aż zostanie odczytany, odczytać jego dokumenty, pobrać oryginał, usunąć go.
- Na ocost.io: [Pricing](https://ocost.io/en/pricing), [Data sovereignty](https://ocost.io/en/data-sovereignty)
