MINARA

解析消息 chat id

POST /v1/gateway/providers/:id/resolve-chat-id:查询 Telegram 机器人的 chat id。请求体可选带 botToken,且不会保存。

POST /v1/gateway/providers/:id/resolve-chat-id

查询 Telegram 机器人应发送到的 chat id。JSON 请求体可选带 botToken,它仅用于本次查询且不会保存;省略时,gateway 使用已保存的 token。仅支持 Telegram;其他 provider id 返回 404。该端点报告当前状态后立即返回而不阻塞,因此由调用方轮询:found 带回 chat id;awaiting_start 表示用户还没给机器人发过消息;conflict 表示正在运行的 daemon 占用着 Telegram 的 getUpdates(继续轮询即可;用户发出的消息会经由 daemon 到达解析逻辑);invalid_token 表示传入或已保存的 token 不可用。

方法POST
路径/v1/gateway/providers/:id/resolve-chat-id
认证设置 GATEWAY_AUTH_TOKEN 时需要 Authorization: Bearer <token>
类别gateway

请求体

{ "botToken": "123456789:AAH..." }

响应体

{ "status": "found", "chatId": "42", "username": "my_bot" }

本页目录