不同开发语言调用国际短信接口的要点

调用方式其实只有一种

不少开发者第一次对接时会问：我们团队用 PHP，能不能对接？答案是可以。国际短信接口本质上是一个标准 HTTP/HTTPS 接口，POST 表单提交，只要开发语言能发起 HTTPS 请求、能读写 JSON 响应，就能完成对接。

区别只在于每种语言的请求库写法不同。达信通提供 Java(HttpClient)、PHP(curl)、Python、Node.js、Go 等多种语言示例，均为 POST form 方式，参数完全一致。

各语言示例要点

• PHP：用 curl 库设置 POST，Content-Type 为 application/x-www-form-urlencoded，表单字段拼好即可；
• Python：使用 requests 库，data 字典传入参数，注意校验返回 code；
• Java：HttpClient 构造表单请求，处理超时与重试；
• Node.js：用内置 https 模块或 axios 发起 POST，异步处理响应。

国际短信接口参数与响应的共性

无论用哪种语言，请求地址统一为 https://api.dxtong.com/isms/Submit.json，UTF-8 编码。核心参数三组：account 填 APIID，password 填 APIKEY 或动态密码，mobile 与 content 按格式填写。响应 code=2 表示提交成功，并返回 ismsid 流水号。

动态密码方式下，password 为 md5(account+password+mobile+content+time)，time 为 10 位 Unix 时间戳，且为必填。不同语言的 md5 库都能直接计算。

异步处理与重试策略

实际业务中，短信提交通常由后端服务触发。验证码请求量在高峰时段集中，接口调用应放在异步队列里处理，避免阻塞主业务响应。发送失败时，区分参数错误与网络超时：参数错误不要盲目重试，网络超时可在记录日志后择机再发。

达信通接口返回的 code 是重试判断的依据。code=2 后不要重复提交，改为等待回执；其他状态码按原因分类处理，重试次数与间隔在业务侧自行控制。联调环境与生产环境使用同一套参数规范，区别只在测试号码与发送频率，建议保留一组联调脚本，上线后排查问题时仍可复用。

联调时的注意事项

1. 先用测试号码提交，确认 code=2 后再切生产；
2. 回执接收地址单独准备，收到推送后返回 success；
3. 失败状态码按文档对照处理，如 405 账号或密码不正确、406 手机格式不正确。

达信通国际短信接口全天 24 小时可提交，接入期间有客户经理跟进。需要示例代码或联调支持，可联系达信通客户经理，或拨打 400 118 6878。使用国际短信接口，选团队熟悉的语言即可快速上手。