rtk-vats

Навык: Виртуальная АТС Ростелеком

Работа с телефонией идёт через сервис rtk-vats-api — обёртку над внутренним API личного кабинета ВАТС (/webapi, ~240 эндпоинтов). Доступ: MCP-инструменты vats_* (предпочтительно) или REST с заголовком X-API-Key.

Адрес сервиса: http://127.0.0.1:8010 по умолчанию (в развёрнутом виде — адрес, который назовёт пользователь). OpenAPI: /docs.

Авторизация: логин + пароль + код из SMS

Один раз на сессию. Дальше сервис держит её сам — токен обновляется в фоне, пока сервис запущен.

KEY="X-API-Key: $API_KEY"; H="http://127.0.0.1:8010"

# 0. Проверить — возможно, вход уже есть
curl -s $H/auth/status -H "$KEY"          # authenticated: true/false

# 1. Логин и пароль «Ростелеком Паспорта» -> на телефон владельца уходит SMS
curl -s -X POST $H/auth/login -H "$KEY" -H 'Content-Type: application/json' \
     -d '{"username":"lk_1234567890","password":"..."}'
# -> {"status":"code_required","hint":"Мы отправили код на номер +7 914 …","seconds_to_enter_code":300}

# 2. СПРОСИТЬ КОД У ПОЛЬЗОВАТЕЛЯ и отправить
curl -s -X POST $H/auth/code -H "$KEY" -H 'Content-Type: application/json' -d '{"code":"123456"}'
# -> {"status":"ok","seconds_left":1435,"has_refresh_token":true,"has_fingerprint":true}

MCP: vats_auth_status → vats_auth_login → vats_auth_code.

Правила этого шага:

• Учётные данные спрашивать у пользователя, если он их не дал. Пустые username/password означают «взять из конфигурации сервиса» — это нормальный вариант, сначала попробовать его.
• Код из SMS никогда не выдумывать и не подбирать. Спросить и дождаться. Неверный код тратит попытку, а повторную SMS Паспорт присылает с задержкой.
• На ввод кода есть ~5 минут (seconds_to_enter_code). Не успели — начать с /auth/login заново.
• SMS не пришла или передумали — POST /auth/cancel (vats_auth_cancel), чтобы не держать попытку.
• Проверить, что сессия живая и продлевается — POST /auth/refresh (vats_auth_refresh).

Ответ 503 / auth_required от любого другого роута = сессия потеряна, начать вход заново.