# OpenAPI и Postman

Источник: https://dev.smartpdf.ru/docs/openapi

## OpenAPI

Схема публичных запросов — загрузка, 24 операции, статус, скачивание, цепочки, баланс и цены: [openapi.json](https://dev.smartpdf.ru/openapi.json). Из неё можно сгенерировать клиент на любом языке (например, OpenAPI Generator) или импортировать в Insomnia и Bruno.

## Postman

Коллекция со всеми запросами и примерами тел: [postman.json](https://dev.smartpdf.ru/postman.json). Импортируйте её в Postman и задайте переменную `apiKey`.

## Попробовать запрос в браузере

Интерактивная документация Swagger — [api.smartpdf.ru/docs](https://api.smartpdf.ru/docs): нажмите **Authorize** и вставьте ключ `sk_live_…` в поле HTTPBearer — он работает и как `Authorization: Bearer`.

## Версия API

Адреса начинаются с `/v1`. Совместимые изменения — новые операции, параметры и поля ответа — приходят без смены версии: не отказывайте ответам с незнакомыми полями.

## Для агентов

Документация доступна агентам: [llms.txt](https://dev.smartpdf.ru/llms.txt) — оглавление со ссылками, у каждой страницы есть Markdown-версия (адрес страницы + `.md`).