浏览文档目录

机器人

鉴权

开放平台有两套凭证,用途不同,不要混用。

Bot Token(运行时)

格式 sbot_…,请求头:

Authorization: Bearer sbot_xxx

用于 /api/v1/bots/sendMessage、setWebhook、getUpdates 等机器人运行时接口。审核通过后才会签发;控制台「概览」里一次性展示明文,或通过「重新生成」换发(旧 Token 立刻失效)。

账号 JWT(控制台)

使用 SoChat 用户登录开放平台后获得。请求头:

Authorization: Bearer <账号 JWT>

用于 /api/v1/bots/applications、/api/v1/bots/my/**:申请机器人、配 Webhook、看投递日志、改资料,以及管理独立的联享券模板。完整参数见 API 索引 中「开发者控制台 API」各条。

Base URL

网关前缀一般为 https://<你的 API 域名>/api/v1。请以控制台提供的地址为准,并将 SDK 的 baseUrl / apiBase 指向该前缀。

Token 只放服务端环境变量(如 SOCHAT_BOT_TOKEN)。前端页面、公开仓库、截图里都不要出现完整 Token。