腾讯云公告 > 公告详情
扫码查看公告

【短信】国际/港澳台短信回执错误码升级的公告

为进一步提升国际/港澳台短信服务的错误诊断能力与接入体验，腾讯云短信将于2026年12月01日起逐步灰度上线国际/港澳台短信全新标准回执错误码，并在接口回包中新增子错误码及对应错误说明字段。现将相关事项公告如下：
变更内容
1、上线国际/港澳台短信全新标准回执错误码：
新错误码体系对错误原因的划分更加精细、规范，帮助您更准确地定位发送失败原因。具体详见《国际/港澳台短信回执错误码》。
2、接口输出参数新增字段：
2.1 短信下发状态通知请求参数新增以下两个字段：
● 子错误码：string类型，非必选字段,字段名称sub_error；
● 子错误码说明：子错误码描述，string类型，非必选字段，字段名称sub_error_desc。
2.2 拉取状态相关接口/拉取短信下发状态PullSmsSendStatus结构新增以下两个字段
● 子错误码：string类型，非必选字段，字段名SubError；
● 子错误码说明：子错误码描述，string类型，非必选字段，字段名SubErrorDesc。
2.3 拉取状态相关接口/拉取单个号码短信下发状态PullSmsSendStatus结构新增以下两个字段
● 子错误码：string类型，非必选字段，字段名SubError；
● 子错误码说明：子错误码描述，string类型，非必选字段，字段名SubErrorDesc。
2.4 短信查询相关接口/查询短信下发记录SendRecord结构新增以下两个字段
● 子错误码：string类型，非必选字段，字段名SubError；
● 子错误码说明：子错误码描述，string类型，非必选字段，字段名SubErrorDesc。
请您重点关注：
1、请评估当前接入方式对新增字段的兼容性：
新增字段为兼容式新增，不影响原有字段的返回；但如果您的系统对接口回包做了严格字段校验（如对未知字段报错、严格反序列化等），请提前适配，避免出现解析异常。
2、请及时更新基于回执错误码的业务逻辑映射关系：
若您当前基于回执错误码实现业务判断、重试或告警逻辑，请及时对照新版《国际/港澳台短信回执错误码》文档更新错误码映射关系，确保业务逻辑与新错误码一致。