Перейти к основному содержимому

agent-auto-auth

Эндпоинтов: 2

POST /api/auth/agent/disconnect​

Отключить доступ доверенного агента

Авторизация: Публичный

Только сервер агента. Конструктор доверяет удостоверению отправителя этим сервером. HMAC-SHA256 подписывает METHOD + LF + PATH + LF + TIMESTAMP + LF + NONCE + LF + SHA256(raw body). Лимиты: 10/мин на пользователя, 300/мин на агента, 20 неверных подписей/мин на IP. PAT: read,write, без bot_manager, 24 часа, обновление за 5 минут; старый PAT доживает свой срок. Отключение отзывает все связанные PAT. Восстановление только браузерной сессией владельца. Не является инструментом MCP. Ответ Cache-Control: no-store.

Operation ID: post_api_auth_agent_disconnect_5f3bc4c93a146350

Параметры​

ИмяInОбязательныйОписаниеПример
X-Agent-IdheaderдаИдентификатор доверенного агента—
X-Agent-TimestampheaderдаUnix timestamp, допуск 60 секунд—
X-Agent-Nonceheaderда16 случайных байт hex; хранится в Redis 120 секунд—
X-Agent-SignatureheaderдаHMAC-SHA256, lowercase hex—

Ответы​

КодОписание
200Успех
400INVALID_REQUEST
401UNAUTHORIZED: подпись или время
403CONNECTION_REVOKED или AUTO_AUTH_NOT_ALLOWED
409REPLAY_DETECTED
429RATE_LIMITED
503AUTO_AUTH_UNAVAILABLE: ключ, Redis или БД недоступны

POST /api/auth/agent/telegram​

Доверенный обмен Telegram ID на PAT

Авторизация: Публичный

Только сервер агента. Конструктор доверяет удостоверению отправителя этим сервером. HMAC-SHA256 подписывает METHOD + LF + PATH + LF + TIMESTAMP + LF + NONCE + LF + SHA256(raw body). Лимиты: 10/мин на пользователя, 300/мин на агента, 20 неверных подписей/мин на IP. PAT: read,write, без bot_manager, 24 часа, обновление за 5 минут; старый PAT доживает свой срок. Отключение отзывает все связанные PAT. Восстановление только браузерной сессией владельца. Не является инструментом MCP. Ответ Cache-Control: no-store.

Operation ID: post_api_auth_agent_telegram_9deae6f23c3591bb

Параметры​

ИмяInОбязательныйОписаниеПример
X-Agent-IdheaderдаИдентификатор доверенного агента—
X-Agent-TimestampheaderдаUnix timestamp, допуск 60 секунд—
X-Agent-Nonceheaderда16 случайных байт hex; хранится в Redis 120 секунд—
X-Agent-SignatureheaderдаHMAC-SHA256, lowercase hex—

Ответы​

КодОписание
200Успех
400INVALID_REQUEST
401UNAUTHORIZED: подпись или время
403CONNECTION_REVOKED или AUTO_AUTH_NOT_ALLOWED
409REPLAY_DETECTED
429RATE_LIMITED
503AUTO_AUTH_UNAVAILABLE: ключ, Redis или БД недоступны