常见问题

语音通知接入与使用中的高频问题汇总。错误码速查见 错误代码。

接入与认证

请求要带什么凭证？

请求头 Authorization: Bearer {API_KEY}，API Key 在 Console > Developers 创建；语音接口暂不支持 CheckSum 验签。参见 鉴权。

返回 401 怎么排查？

按顺序确认：请求带了 Authorization 头、API Key 正确未删除、账号/API Key/产品授权均处于生效状态。对应场景见 错误代码 的 HTTP 401 行。

返回 403「IP 不在白名单」？

IP 白名单是必配项：API Key 未配置白名单时所有请求都会被拒绝。请在平台为 API Key 配置出口 IP 白名单后再调用；多条白名单记录取并集，变更后最长约 60 秒生效。

发送与结果

API 返回 000000，为什么被叫没接到电话？

000000 只表示任务受理成功。实际外呼可能未接通、正在重拨等待中或线路异常。用 发送记录 查看逐通状态与结束码。

重拨是什么语义？会多计费吗？