请求方式:POST 与 GET 都支持 国际短信接口的提交地址为 https://api.dxtong.com/isms/Submit.json,POST 与 GET 两种方式均可使用。实际开发中更推荐 POST,因为短信正文较长时,POS…
请求方式:POST 与 GET 都支持
国际短信接口的提交地址为 https://api.dxtong.com/isms/Submit.json,POST 与 GET 两种方式均可使用。实际开发中更推荐 POST,因为短信正文较长时,POST 在请求体中传递内容更稳定,也不容易触发 URL 长度限制。
请求头固定为 Content-Type: application/x-www-form-urlencoded,参数以表单形式提交。无论选用哪种语言的 HTTP 客户端,都按这个请求头组织参数。
编码要求:统一 UTF-8
多语种内容是国际短信的常态。中文、英文、阿拉伯语、俄语、泰语等语种混排时,编码必须统一为 UTF-8,否则会出现乱码,内容与报备模板不一致也会导致发送失败。
- 服务端发送请求前确认字符集为 UTF-8;
- 数据库与业务系统存储短信内容时同样使用 UTF-8;
- 回执接收页面按 UTF-8 解析平台推送的参数;
- 涉及用户昵称等自由文本时,入库与出库都按同一编码处理。
参数与响应的处理要点
参数 account、password、mobile、content 均按表单字段传递。响应中 code=2 表示提交成功,同时返回 ismsid 流水号用于后续回执关联。常见错误码如 405 账号或密码不正确、406 手机格式不正确、407 内容含敏感字符,都可以据此快速定位。
语言示例覆盖 Java HttpClient、PHP curl、Python、Node.js、Go 等,均为 POST form 方式,开发时可直接参考。这些示例把请求头、参数组织、响应解析都写得比较完整,接入时照搬即可。
接入节奏
实际接入时,建议先用 GET 方式跑通一次请求,确认参数与响应正常,再切换为 POST 方式用于生产。GET 方式适合快速验证参数,POST 方式适合承载较长的短信正文。编码问题往往在第一次发送多语种内容时才暴露,提前用一条含中文与小语种的内容测试,可以避免上线后临时排查。
响应解析也要统一处理:code=2 进入成功分支,其他 code 进入失败分支并记录日志,不要把非成功响应当成异常直接抛出。达信通国际短信接口全天 24 小时可提交,回执可查,接入期间有客户经理跟进。需要了解更多,可联系达信通客户经理,或拨打 400 118 6878。使用国际短信接口,把请求方式与编码确认清楚,联调过程会更顺利。