Octri: генератор документации API и клиентских SDK

Octri — генератор документации API и платформа для команд, которые хотят поддерживать справочник, клиентские библиотеки и инструменты для ИИ на основе одной спецификации. Помимо публикации документации, сервис предлагает мониторинг работы интеграций.

Что делает Octri простыми словами?

Спецификация API похожа на техническую инструкцию: какие запросы принимает сервис, какие данные нужны и что он возвращает. Octri превращает эту инструкцию в сайт для разработчиков, устанавливаемые программные библиотеки и инструменты, через которые ИИ-помощник может обращаться к API.

Это полезно разработчикам SaaS, поставщикам API и небольшим командам, которым приходится поддерживать несколько клиентских интеграций. Сам работающий API и корректная спецификация по-прежнему нужны. Созданные объяснения и код следует проверять. Можно использовать отдельные модули, не подключая всю платформу сразу.

Как пройти путь от спецификации до публикации

API Studio принимает файл спецификации или подключённый репозиторий GitHub. На его основе создаются описания операций, схемы и примеры запросов. Страницы можно редактировать, а инструкции по авторизации и подключению — дополнять собственными материалами MDX.

1. Загрузите спецификацию и проверьте названия операций, авторизацию, входные данные и ответы.
2. Сгенерируйте справочник, затем сравните объяснения с реальным поведением API.
3. Выполните пробный запрос в тестовой среде через интерактивную консоль. Проверьте также ошибочный ответ. Запросы идут из браузера, поэтому важны настройки CORS вашего API.
4. Настройте публикацию, нужные языки SDK и подключения к реестрам пакетов.
5. Изучите черновик и различия версий, затем подтвердите публикацию.

Синхронизация с GitHub доступна на всех тарифах. Изменение спецификации может запускать пересборку, но публикация новой версии SDK в реестр в описанном официальном процессе требует подтверждения.

Какие клиентские SDK можно подготовить

SDK Studio поддерживает TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Rust, Swift и Dart. Можно настраивать имена методов, исключать отдельные операции и задавать параметры языка. Интеграции с реестрами пакетов помогают доставить библиотеку пользователям.

Десять языков — возможности платформы в целом: число одновременно доступных языков зависит от тарифа. Собственный код в SDK указан начиная с Growth. Перед выпуском проверьте авторизацию и нестандартные схемы ответов на вашем API.

Бесплатный тариф и стоимость расширения

Проверено 6 октября 2026 года. Ниже указаны официальные месячные цены в долларах США без налогов, без пересчёта в местную валюту:

• Free: один проект, один язык SDK, 50 операций API, 100 МБ мониторинга в месяц и 100 разовых ИИ-кредитов.
• Starter: 49 долларов в месяц, два языка SDK.
• Growth: 99 долларов в месяц, четыре языка, версии документации и собственный код/компоненты.
• Business: 249 долларов в месяц, все десять языков и возможности white label.
• Enterprise: цена по запросу; генератор и средство отображения документации можно разместить в своей инфраструктуре.

Генерация одной операции или один ответ Ask-the-docs расходует один ИИ-кредит. Ручное редактирование, сборки SDK и хостинг не расходуют эти кредиты. После их исчерпания приостанавливаются ИИ-генерация и ответы, а опубликованные страницы, сборки и мониторинг продолжают работать. Полные квоты и дополнения приведены в сравнении тарифов Octri.

Собственный домен и синхронизация GitHub доступны и на Free.

Как отслеживаются ошибки и обрабатываются данные

Мониторинг отключён по умолчанию. Для сгенерированных SDK и поддерживаемых серверных пакетов доступны журналы, группировка проблем, трассировки, проверки доступности и уведомления. Octri описывает удаление чувствительных данных на стороне клиента и повторно при приёме событий.

Согласно политике конфиденциальности, для генерации соответствующие части спецификации передаются поставщику модели; для Ask-the-docs передаются вопрос и найденные фрагменты. Документация также обрабатывается для поисковых эмбеддингов. Octri заявляет, что эти материалы не используются для обучения моделей ни им, ни поставщиками. Это обработка в размещённом сервисе, а не полностью локальная генерация.

Как подключить документацию к ИИ через MCP

MCP-сервер Octri предоставляет семь инструментов для работы с документацией и может представлять включённые операции API как исполняемые инструменты. Claude, Cursor и другие MCP-клиенты получают доступ к опубликованному справочнику.

Для чтения документации достаточно идентификатора проекта. Вызовы API требуют подходящих учётных данных; они остаются на машине, где работает сервер. До подключения выберите тестовую или рабочую среду, ограничьте права и исключите операции, которые не должны быть доступны агенту.

Частые вопросы

Можно ли начать бесплатно?

Да, в пределах Free. Сто кредитов выдаются один раз, а не каждый месяц. Перед подключением проекта оцените число операций и нужных языков SDK.

Какие спецификации поддерживаются?

Официально перечислены OpenAPI 3.0/3.1, Swagger 2.0, Postman и AsyncAPI в JSON или YAML. После импорта проверьте схемы и примеры, особенно после преобразования из другого формата.

Сохраняются ли ручные правки?

Octri заявляет, что сохраняет вручную изменённые поля, обновляя остальные сгенерированные поля. При изменении спецификации всё равно стоит просмотреть черновик и различия версий.

Официальная документация и помощь

• Документация Octri: начало работы, руководства по SDK и настройка MCP.
• Octri на GitHub: открытые пакеты и сообщения об ошибках SDK.
• Поддержка продукта и оплаты: официальные каналы помощи.