# API Ocost
> Co robi API Ocost (odczytuje dokumenty firmowe jako dane strukturalne i je przeszukuje), jego adres, klucze, format i trasy.

Wysyłaj do Ocost dokumenty firmowe, na przykład faktury, zamówienia i umowy. Ocost je odczytuje, zapisuje, księguje i dopasowuje, a Ty dostajesz każdy z powrotem jako uporządkowany JSON. Możesz też przeszukiwać wszystko, co Twoja firma przechowuje w Ocost.

| Co | Wartość |
| --- | --- |
| Adres | `https://api.ocost.io/public/v1` |
| Klucz | `Authorization: Bearer ocost_sk_…`, z [Ustawienia › Programiści](https://app.ocost.io/settings/api) |
| Format | JSON, pliki jako `multipart/form-data`, błędy jako problemy RFC 9457 |
| Dokumenty | [`ocost.document.v1`](https://ocost.io/docs/pl/document.md), w pojęciach EN 16931 |
| Gdzie | W UE. Dokumenty nigdy nie trenują żadnego modelu. |

## Trasy

| Trasa | Co robi |
| --- | --- |
| `POST /public/v1/files` | Wysyła plik |
| `GET /public/v1/files` | Pliki zmienione od danej chwili lub kursora |
| `GET /public/v1/files/{file_id}` | Plik i jego status |
| `GET /public/v1/files/{file_id}/content` | Oryginalne bajty |
| `GET /public/v1/files/{file_id}/document` | Jego pierwszy dokument |
| `GET /public/v1/documents/{document_id}` | Dowolny dokument |
| `DELETE /public/v1/files/{file_id}` | Usuwa plik na zawsze |
| `GET /public/v1/search` | Szuka po słowach i po znaczeniu |

Zacznij od [Szybkiego startu](https://ocost.io/docs/pl/quickstart.md). [Dokumentacja API](https://ocost.io/docs/openapi.json) zawiera każde pole. Co Ocost odczytuje w poszczególnych krajach, opisują strony [Niemcy](https://ocost.io/docs/pl/germany.md) i [Ukraina](https://ocost.io/docs/pl/ukraine.md).

## Korzystanie z asystentów AI

Claude, ChatGPT, Cursor i inni asystenci czytają te przewodniki jako Markdown:

- `https://ocost.io/docs/llms.txt`: mapa wszystkich przewodników
- `https://ocost.io/docs/llms-full.txt`: wszystkie przewodniki w jednym pliku, po angielsku
- `https://ocost.io/docs/openapi.json`: dokument OpenAPI
- **Kopiuj stronę dla AI**, obok każdego tytułu

Prompt do integracji z Odoo:

```text
Przeczytaj https://ocost.io/docs/llms.txt i przewodniki, do których prowadzi, najpierw przewodnik o Odoo. Potem napisz moduł Odoo 19, który wysyła PDF szkicu faktury zakupowej do API Ocost, odpytuje plik, aż zostanie odczytany, i wypełnia kontrahenta, numer, daty i pozycje faktury z jego ocost.document.v1, nie księgując jej. Przechowuj klucz API w parametrze systemowym ocost.api_key.
```

## Zobacz też

- [Szybki start](https://ocost.io/docs/pl/quickstart.md): Pięć kroków do pierwszej faktury jako JSON: zarejestruj się, utwórz klucz, wyślij PDF, poczekaj, aż zostanie odczytany, odczytaj jego dokument. curl, Python i JavaScript.
- [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.
- [Podłączyć asystenta](https://ocost.io/docs/pl/mcp.md): Podłączyć asystenta do serwera MCP (https://api.ocost.io/public/mcp, te same klucze): Claude Code, Claude Desktop, Cursor, claude.ai i ChatGPT przez OAuth oraz każdy klient.
- [Dokument](https://ocost.io/docs/pl/document.md): Schemat ocost.document.v1 w pojęciach EN 16931 (odwzorowywalny na UBL i CII): przykład, rodzaj i kierunek, źródła, kontrole, wersje oraz każde pole i każda wartość.
- Na ocost.io: [API and MCP](https://ocost.io/en/product/api-and-mcp), [Pricing](https://ocost.io/en/pricing)
