跳到主要内容

Developer FAQ

DeBox 开发者 FAQ / 排障​

本页聚焦开发者接入中的高频问题与定位思路。
新开发请以以下主文档为准：

1. 我应该先看哪篇文档？​

按接入路径选择：

  • 接口参数、值域、成功/失败响应：看 OpenAPI。
  • 用 Go SDK（Long Polling）：看 GO-SDK。
  • 用 Webhook：看 GO-SDK Webhook。

2. 为什么 getUpdates 一直收不到消息？​

最常见原因：已经配置了 Webhook URL。
DeBox 中 Webhook 与 Long Polling 严格互斥：

  • 配置 Webhook 后，Webhook 是唯一有效收消息链路。
  • 想用 Long Polling，先清空平台上的 Webhook 配置。

3. chat_id 和 chat_type 应该怎么填？​

  • chat_type=group：chat_id 填群 gid（如 cc0onr82）。
  • chat_type=private：chat_id 填用户 user_id（invite code）。

这两个字段是 sendMessage / editMessage 的核心路由参数。

4. parse_mode 选了 image/video/file，content 填什么？​

必须填可公网访问 URL：

  • image：图片 URL
  • video：视频 URL
  • file：文件 URL

文本类（richtext/text/Markdown/MarkdownV2/HTML）content 最大 5000 字符。

5. Bot 回调的安全校验怎么做？​

Webhook 回调请求头会携带：X-API-KEY = Webhook Key。
服务端必须校验该值，避免伪造请求。

排查提醒：

  • 修改 Webhook URL 后，Webhook Key 会更新。
  • 服务端也要同步更新校验值。

6. 发送消息返回失败怎么查？​

建议按顺序检查：

  1. 请求头是否带 X-API-KEY。
  2. chat_type/chat_id 是否匹配。
  3. content 是否为空或超限。
  4. parse_mode 与 content 格式是否一致。
  5. 若是签名接口（如 dao_member），检查 nonce/timestamp/signature。

7. 常见错误与处理​

  • message can't be empty：content 为空。
  • message must be less than 5000 characters：文本类消息超长。
  • message must be less than 2000 bytes：粉丝群发内容超限。
  • permission denied：调用方无目标群管理权限。
  • Param error：参数缺失或格式不合法（常见于地址格式）。

8. 如何获取 gid（群 ID）？​

在 App 内进入目标群，使用“分享/复制链接”，链接中的 id 即 gid。

9. 技术支持渠道​