OpenAPI и Postman

#OpenAPI

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

#Postman

Коллекция со всеми запросами и примерами тел: postman.json. Импортируйте её в Postman и задайте переменную apiKey.

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

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

#Версия API

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

#Для агентов

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