语音通知接口联调常见问题：测试额度与调试技巧

一、免费调试额度怎么用

注册互亿无线账户后会赠送 10 条免费调试额度，足够在正式购买前验证接口连通性与播报效果。这 10 条按成功计费扣减，建议优先用自己或测试号码拨打，确认音色、语速与内容无误后再提交正式模板。正式套餐最低 1500 元起购，且无有效期，用完免费额度后可联系商务充值正式套餐。

二、模板报备与审核

语音通知采用免报备签名、仅需报备模板的策略。在控制台填写播报模板内容并提交，约 2 小时审核通过后即可用于生产。报备时注意文案不要出现营销诱导类词语，避免审核驳回；模板上限 500 字，TTS 自动合成、多音色可选，无需提前录音。审核通过后 content 直接填入该模板文本即可。

三、code 判断与常见错误

接口返回 JSON，例如 {"code":2,"msg":"提交成功"}。code 等于 2 表示提交成功；其他 code 对应不同错误。返回非 2 时先打印完整 JSON，对照 msg 提示修正，不要盲目重发。常见排查方向如下：

• 凭证错误：检查 account 与 password 是否填反、是否多空格；
• 号码格式错误：mobile 需为合法手机号；
• 内容超长：单条约 70 字（约 20 秒播报），模板上限 500 字；
• 余额不足：充值后再试，按成功计费、失败不计费。

四、联调技巧

1. 先在 Postman 或 curl 中跑通请求，再写入业务代码；
2. 把每次返回的完整 JSON 落日志，便于对账与回溯；
3. 用测试号码反复验证变量替换效果，确认播报自然；
4. 确认失败不计费，正式拨打前先用免费额度摸底；
5. 配合状态查询接口或回调推送，核对呼叫状态与通话时长；
6. 联调期间关闭自动补呼，避免测试号码反复响铃。

完整错误码见接口文档，各语言 DEMO 见代码示例页面。