ИИ-ассистенты для разработки могут ускорить интеграцию только тогда, когда работают с точными и актуальными источниками. Мы полностью обновили публичную документацию API CoinsSend, чтобы разработчики и совместимые ИИ-агенты использовали один и тот же проверенный контракт, примеры и рекомендации по безопасности.
В обновление вошли публичный MCP-сервер только для чтения, канонический документ OpenAPI 3.1, удобный для языковых моделей индекс документации, тестовые векторы подписей запросов и усиленные автоматические проверки. Теперь изучать API и готовить код интеграции можно быстрее, при этом учётные данные и платёжные операции остаются под контролем разработчика.
Единый проверенный источник для разработчиков и агентов
Новый слой документации предоставляет каждому инструменту наиболее подходящий для него формат:
- MCP для ИИ-агентов. Совместимый клиент может искать по публичной документации, получать конкретную страницу, изучать операцию OpenAPI или загружать схему компонента.
- OpenAPI 3.1 для инструментов разработки. Публичный контракт подходит для генерации кода, валидации, изучения API и интеграционных тестов.
- llms.txt и манифест документации. Агенты без поддержки MCP могут находить канонические публичные страницы, не сканируя посторонний контент.
- Исполняемые тестовые векторы подписей. Команды могут проверять канонический JSON, устаревшие подписи MD5 и HMAC-подписи вывода средств с временной меткой по опубликованным примерам.
- Серверные примеры и промпты с защитными ограничениями. Документация содержит примеры на PHP, JavaScript/Node.js и Python, а также промпты для реализации checkout, webhooks и проверки готовности к продакшену.
Контракт OpenAPI намеренно охватывает проверенный набор публичных операций и не раскрывает внутренние маршруты приложения. Благодаря этой границе машиночитаемый интерфейс остаётся полезным и пригодным для аудита.
Подключите ИИ-агента за несколько минут
Удалённый сервер документации доступен по адресу https://api.coinssend.com/v1/docs/mcp. Например, пользователи Codex могут добавить его командой:
codex mcp add coinssend-docs --url https://api.coinssend.com/v1/docs/mcpДля этого подключения не нужен API-ключ CoinsSend, потому что сервер предоставляет только публичную документацию. Другие совместимые MCP-клиенты могут использовать тот же endpoint в соответствии со своим процессом подключения. Полные инструкции приведены в руководстве по MCP.
С чем может помочь агент
После подключения сервера документации ИИ-агент может:
- найти нужный рабочий процесс, например инвойсы, статические кошельки, webhooks, вывод средств, комиссии, балансы или курсы монет;
- получить конкретную страницу публичной документации вместо результатов общего веб-поиска;
- найти операцию по
operationIdи изучить схемы её запроса, ответа, аутентификации и ошибок; - использовать опубликованные примеры подписей для тестирования реализации подписания запросов в приложении;
- подготовить серверный код интеграции и тесты, которые инженер сможет проверить и запустить.
Если перед внедрением вы выбираете между платёжными моделями, наше руководство по статическим кошелькам и инвойсам разбирает компромиссы каждого варианта с точки зрения продукта. Затем документация для ИИ-агентов предоставляет точный контракт API для выбранного пути.
Чёткая граница безопасности
MCP-сервер работает только в режиме чтения. Он не может создать инвойс, сгенерировать кошелёк, инициировать вывод средств, получить доступ к аккаунту мерчанта или принять его учётные данные. Инструменты сервера ограничены проверенным корпусом публичной документации и спроектированы как неразрушающие и идемпотентные.
Код интеграции по-прежнему должен выполняться на доверенном сервере. Храните ключи мерчанта в защищённых переменных окружения или менеджере секретов, подписывайте запросы на сервере, проверяйте подписи webhooks по необработанному телу запроса и просматривайте сгенерированный код перед выполнением. Запросы на запись должны учитывать документированные правила повторных попыток — их нельзя повторять вслепую.
OpenAPI, тестовые векторы и прямой доступ
Те же исходные материалы доступны и без MCP:
- контракт OpenAPI 3.1 с машиночитаемыми операциями и схемами;
- llms.txt с компактным индексом для агентов;
- манифест документации с каноническим публичным корпусом;
- тестовые векторы подписей для проверки совместимости реализации;
- промпты для интеграции с ИИ для структурированных задач по реализации и ревью.
Команда может подключить агента с поддержкой MCP, импортировать OpenAPI в существующий набор инструментов или работать непосредственно с документацией — во всех случаях источником истины останутся одни и те же материалы.
Проверки, которые поддерживают соответствие контракта
Теперь изменения документации проходят автоматические проверки согласованности, линтинг OpenAPI, обнаружение несовместимых изменений и тесты runtime-контракта, которые сопоставляют опубликованную спецификацию с реальными публичными маршрутами, контроллерами и middleware. Отдельные тесты охватывают MCP-сервер, корпус документации, подписи запросов и управляемую синхронизацию с OpenAI Vector Store, используемую ассистентом документации CoinsSend.
Процесс синхронизации подготавливает и проверяет новый публичный корпус до удаления прежних управляемых файлов. Блокировки, пагинация, тайм-ауты, проверки владения и очистка снижают вероятность публикации неполного или непредусмотренного корпуса.
Начните с рабочего процесса, затем проверьте детали
Откройте руководство по началу работы, подключите сервер документации, если ваш ИИ-агент поддерживает MCP, и опишите платёжный процесс, который хотите реализовать. Попросите агента сослаться на конкретную страницу документации, операцию OpenAPI и использованную схему. Затем проверьте результат, запустите тестовые векторы подписей и тесты и провалидируйте интеграцию в своей среде.
Это обновление не превращает платёжную интеграцию в непроверенное действие в один клик. Оно даёт разработчикам и их инструментам более быстрый и надёжный способ найти правильный контракт и реализовать интеграцию на его основе.
