OpenAPI, Postman, Swagger

Все методы можно открыть в интерактивном просмотрщике Scalar (или Swagger UI) и вызвать прямо из браузера.

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

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

Спецификация – источник истины: если документация расходится со спецификацией, верна спецификация.

Postman

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

Свой клиент

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

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

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

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

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