开发者指南
接入与凭证
先选能力，再选身份。文档可公开阅读，资源配置需要登录并具备相应权限。
选择接入路径
机器人
把通知、自动化与业务助手接入会话。
- 登录并提交机器人申请
- 审核通过后生成 Bot Token
- 选择 Webhook 或轮询，验证消息收发
开放应用
用联享券连接权益发放与业务履约。
- 登录并创建开放应用
- 配置凭证与来源策略，提交券模板
- 模板审核通过后验证发券与核销
凭证分别用于什么？
| 身份 | 用途 | 保存位置 |
|---|---|---|
| 账号登录态 / JWT | 管理自己有权限的资源、申请、配置与凭证。 | 由控制台登录流程管理 |
sbot_… | 机器人运行时 API；审核通过后签发。 | 你的服务端环境变量或密钥管理系统 |
sop_… | 开放应用的联享券 API；受 Token 权限和来源策略约束。 | 你的服务端环境变量或密钥管理系统 |
登录成功不等于接口授权成功。账号权限、资源归属、审核状态和运行时 Token 的权限需要分别检查。
确认 API 地址
使用当前品牌环境的 API 网关地址，统一前缀是 /api/v1。下面是路径示意，请替换域名和环境变量；不要把控制台域名或页面地址当成 API。
API_BASE=https://<api-host>/api/v1
curl "$API_BASE/bots/me" \
-H "Authorization: Bearer $BOT_TOKEN"先用 GET /bots/me 验证 Bot Token，再验证真实会话内的消息收发。重置 Token 后旧凭证失效，需要同步更新你部署的服务。
完成一次最小闭环
- 机器人：申请通过 → 获取 Token → 接收一条 Update → 向有权限的会话回复消息。
- 开放应用：创建应用与模板 → 模板审核通过 → 配券或发券 → 验券 → 核销 → 在业务系统确认履约结果。
使用自建测试资源与测试接收者。联调完成后，再逐项检查正式上线条件。 查看上线检查 →