# API Ocost
> Що робить API Ocost (читає ділові документи у структуровані дані, шукає в них), його адреса, ключі, формат і маршрути.

Надсилайте в Ocost ділові документи, наприклад рахунки, замовлення й договори. Ocost читає, розкладає, проводить і зіставляє їх, а ви отримуєте кожен назад як структурований JSON. Також можна шукати в усьому, що ваша компанія зберігає в Ocost.

| Що | Значення |
| --- | --- |
| Адреса | `https://api.ocost.io/public/v1` |
| Ключ | `Authorization: Bearer ocost_sk_…`, з [Налаштування › Розробникам](https://app.ocost.io/settings/api) |
| Формат | JSON, файли як `multipart/form-data`, помилки як problems за RFC 9457 |
| Документи | [`ocost.document.v1`](https://ocost.io/docs/uk/document.md), у термінах EN 16931 |
| Де | У ЄС. Документи ніколи не навчають модель. |

## Маршрути

| Маршрут | Що робить |
| --- | --- |
| `POST /public/v1/files` | Надсилає файл |
| `GET /public/v1/files` | Файли, змінені після моменту часу або курсора |
| `GET /public/v1/files/{file_id}` | Файл і його статус |
| `GET /public/v1/files/{file_id}/content` | Оригінальні байти |
| `GET /public/v1/files/{file_id}/document` | Його перший документ |
| `GET /public/v1/documents/{document_id}` | Будь-який документ |
| `DELETE /public/v1/files/{file_id}` | Стирає файл назавжди |
| `GET /public/v1/search` | Шукає за словами і за змістом |

Почніть зі [Швидкого старту](https://ocost.io/docs/uk/quickstart.md). У [довіднику API](https://ocost.io/docs/openapi.json) є кожне поле. Що Ocost читає в кожній країні, описано на сторінках [Німеччина](https://ocost.io/docs/uk/germany.md) і [Україна](https://ocost.io/docs/uk/ukraine.md).

## Використання з ШІ-асистентами

Claude, ChatGPT, Cursor та інші асистенти читають ці посібники як Markdown:

- `https://ocost.io/docs/llms.txt`: карта всіх посібників
- `https://ocost.io/docs/llms-full.txt`: усі посібники в одному файлі
- `https://ocost.io/docs/openapi.json`: документ OpenAPI
- **Копіювати сторінку для ШІ**, біля кожного заголовка

Підказка для інтеграції з Odoo:

```text
Прочитай https://ocost.io/docs/llms.txt і посібники, на які він посилається, спершу посібник про Odoo. Потім напиши модуль для Odoo 19, який надсилає PDF чернетки рахунку постачальника в API Ocost, опитує файл, доки його не прочитано, і заповнює партнера, номер, дати та рядки рахунку з його ocost.document.v1, не проводячи рахунок. Зберігай ключ API в системному параметрі ocost.api_key.
```

## Див. також

- [Швидкий старт](https://ocost.io/docs/uk/quickstart.md): П’ять кроків до першого рахунку в JSON: зареєструватися, створити ключ, надіслати PDF, дочекатися прочитання, прочитати документ. curl, Python і JavaScript.
- [Надіслати файл і прочитати](https://ocost.io/docs/uk/files.md): Надіслати файл, безпечно надіслати його знову, дочекатися прочитання, прочитати його документи, отримати оригінал, видалити його.
- [Підключити асистента](https://ocost.io/docs/uk/mcp.md): Підключити асистента до сервера MCP (https://api.ocost.io/public/mcp, ті самі ключі): Claude Code, Claude Desktop, Cursor, claude.ai і ChatGPT через OAuth, а також будь-який клієнт.
- [Документ](https://ocost.io/docs/uk/document.md): Схема ocost.document.v1 у термінах EN 16931 (відображається на UBL і CII): приклад, вид і напрям, джерела, перевірки, версії, кожне поле і значення.
- На ocost.io: [API and MCP](https://ocost.io/en/product/api-and-mcp), [Pricing](https://ocost.io/en/pricing)
