国际短信接入时手机号格式如何填写

为什么手机号格式容易出错

国际短信接口对 mobile 参数的格式有明确要求。与国内手机号不同，海外号码必须带上国家码，且国家码与号码之间用空格分隔，例如 1 978234523。格式不对，请求会直接返回 406 手机格式不正确。

格式问题是联调阶段常见的报错来源之一，提前规范可以省掉大量排查时间。很多提交失败并非接口本身的问题，而是号码在入库或传递过程中被加了多余符号。

mobile 参数的正确写法

• 单号码提交，一次请求只发一个 mobile；
• 国家码不带加号，直接写数字国家号；
• 国家号与手机号之间用一个空格分隔；
• 去掉号码中的前导零与多余符号，保持纯数字加空格的结构。

业务侧如何清洗号码

用户注册时收集的号码格式千差万别，有的带加号，有的带横线，有的包含前导零。发送前需要在服务端做一次规范化：去除加号、空格、横线等符号，再按国家码与号码拼接成「国家号 空格 手机号」的形式。

清洗逻辑要与国家码判断配合。不同国家的号码长度与国家码规则不同，建议按地区分组校验，发现异常格式直接拦截，不发起无效请求。清洗后的统一格式建议落库，后续发送直接取用，避免每次临时拼接。

提交后的结果确认

格式正确时，响应 code=2 表示提交成功并返回 ismsid 流水号；送达结果通过回执推送确认。达信通国际短信接口全天 24 小时可提交，回执可查，接入期间有客户经理协助排查格式问题。

号码清洗逻辑建议封装成公共方法，注册、登录、通知等所有发短信的入口都走同一套清洗，不要在每个业务模块里各写一套。这样格式规则一旦调整，只需改一处。对清洗后仍无法识别的号码，业务侧直接拦截并提示用户重新填写，不要发起无效请求。

需要了解更多，可联系达信通客户经理，或拨打 400 118 6878。使用国际短信接口，把手机号格式规范做在前面，发送过程会更稳定。