# 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`, ошибки как проблемы RFC 9457 |
| Документы | [`ocost.document.v1`](https://ocost.io/docs/ru/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/ru/quickstart.md). В [справочнике API](https://ocost.io/docs/openapi.json) описано каждое поле. Что Ocost читает в каждой стране, описано на страницах [Германия](https://ocost.io/docs/ru/germany.md) и [Украина](https://ocost.io/docs/ru/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/ru/quickstart.md): Пять шагов до первого счёта в JSON: зарегистрироваться, создать ключ, отправить PDF, дождаться чтения, прочитать документ. curl, Python и JavaScript.
- [Отправить файл и прочитать](https://ocost.io/docs/ru/files.md): Отправить файл, безопасно отправить его повторно, дождаться чтения, прочитать его документы, получить оригинал, удалить его.
- [Подключить ассистента](https://ocost.io/docs/ru/mcp.md): Подключить ассистента к серверу MCP (https://api.ocost.io/public/mcp, те же ключи): Claude Code, Claude Desktop, Cursor, claude.ai и ChatGPT через OAuth и любой клиент.
- [Документ](https://ocost.io/docs/ru/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)
