OpenAPI, Postman, Swagger

Все методы можно открыть в интерактивном просмотрщике Swagger. Там они не только описаны, но и вызываются прямо в окне браузера.

Машиночитаемое описание API – OpenAPI 3.1:

https://api.rewio.ru/v3/openapi.json

Это источник истины: если ответ API расходится с документацией, верен он.

Postman

Import → Link, вставьте адрес спецификации. Затем задайте в окружении переменную с заголовком X-API-Key, и коллекция готова к вызовам.

Свой клиент

Типизированный клиент генерируется из той же спецификации, например openapi-generator:

# Python
openapi-generator-cli generate \
  -i https://api.rewio.ru/v3/openapi.json \
  -g python -o ./rewio-client-python

# TypeScript
openapi-generator-cli generate \
  -i https://api.rewio.ru/v3/openapi.json \
  -g typescript-fetch -o ./rewio-client-ts

Документация для AI-агентов

Кроме спецификации есть текстовые версии документации, которые агент выкачивает сам: llms.txt – карта разделов, а llms-full.txt – всё одним файлом. Готовый промпт для агента есть на странице Интеграция через AI.