机器人
鉴权
开放平台有两套凭证,用途不同,不要混用。
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。