Сведун отдаёт одни и те же инструменты двумя способами: по протоколу MCP для ИИ-клиентов и через REST API для своих ботов и сервисов. Доступ по ключу в заголовке Authorization.
Авторизация
Каждый запрос содержит заголовок с ключом, выданным при подключении:
Authorization: Bearer <ключ>Без ключа или с отозванным ключом шлюз отвечает 401. Ключ хранится у нас только в виде хеша, показать его повторно нельзя: при потере выпустите новый.
MCP
Адрес: https://mcp.svedun.ru, транспорт Streamable HTTP. Поддерживается актуальная ревизия протокола и совместимый режим для клиентов на предыдущих версиях. Клиент получает список инструментов методом tools/list и вызывает их через tools/call. Настройка конкретных клиентов описана на страницах интеграций.
REST
Метод | Путь | Что делает |
|---|---|---|
GET | | состояние шлюза, без ключа |
GET | | инструменты, доступные ключу, с JSON-схемами входа и выхода |
POST | | вызов инструмента, тело: аргументы в JSON |
GET | | описание OpenAPI; с ключом только доступные ему инструменты |
Пример вызова:
curl -X POST https://api.svedun.ru/v1/tools/get_sales_summary/invoke \
-H "Authorization: Bearer <ключ>" -H "Content-Type: application/json" \
-d '{"date_from":"2026-04-01","date_to":"2026-06-30","group_by":"customer","top_n":5}'Ответ содержит структурированный результат и короткое текстовое резюме:
{
"result": { "items": [], "total": { "revenue": 19678359.02, "quantity": 91288 } },
"summary": "Выручка за период: 19678359.02 RUB, групп в ответе: 5."
}Инструменты и области доступа
Инструмент | Область |
|---|---|
| |
| |
| |
| |
| |
| |
| |
Области задаются при выпуске ключа. Инструмент без нужной области не виден в списке и не вызывается. Дебиторская задолженность (область 1c:finance) пока не поддерживается профилем УТ 11.
Лимиты
Число вызовов в месяц задаётся тарифом, частота вызовов ограничена на ключ. При превышении шлюз отвечает 429 с заголовком Retry-After. Период в запросах продаж и заказов не длиннее 366 дней, длинные списки отдаются порциями через next_cursor.
Ошибки
Ошибка инструмента приходит с кодом, сообщением и подсказкой, что сделать:
{ "error": { "code": "PERIOD_TOO_LARGE", "message": "Слишком широкий период", "hint": "Сузьте период date_from–date_to" } }В MCP та же ошибка возвращается как результат инструмента с признаком ошибки, чтобы модель могла исправить запрос. Полный список в разделе коды ошибок.