接入国际短信接口前,先理清三件事 第一次接入国际短信接口,容易把精力花在写代码上,却忽略了准备环节。实际上,接入是否顺利,取决于三件事是否提前想清楚:业务场景、账号凭据、模板内容。 业务场景决定接口用法。验证码、通知、营销三类业务共用一套接…
接入国际短信接口前,先理清三件事
第一次接入国际短信接口,容易把精力花在写代码上,却忽略了准备环节。实际上,接入是否顺利,取决于三件事是否提前想清楚:业务场景、账号凭据、模板内容。
业务场景决定接口用法。验证码、通知、营销三类业务共用一套接口体系,但参数配置、模板要求、合规要求各有差异。先确定发什么类型的短信,再开始对接,顺序对了,后面就顺。
账号与凭据要准备哪些
对接国际短信接口需要两组关键凭据:APIID 与 APIKEY。APIID 即账号标识,APIKEY 为接口密码。发送时,password 参数可直接填 APIKEY,也可使用动态密码,动态密码的计算方式为 md5(account+password+mobile+content+time)。
- 账号与凭据由平台开通后提供,联系客户经理可确认开通进度;
- 凭据保存在服务端,不要写入前端页面或客户端代码;
- 动态密码方式下,time 为 10 位 Unix 时间戳,为必填参数。
模板内容要确认什么
发送前需要完成模板报备。报备时确认模板文字、变量占位、语种与签名。不同语种可以分别报备,营销类内容还需包含退订引导。
模板报备通过后,内容与报备模板一致的请求才能正常发送。变量使用需要控制长度,变量超长会返回对应错误码。
技术侧还需要准备哪些
达信通国际短信接口为标准 HTTP/HTTPS 接口,UTF-8 编码,全天 24 小时可提交。开发侧准备的内容不多:一个可发起 POST 请求的环境、一组用于接收回执的接口地址、若干测试号码。
- 提交地址:https://api.dxtong.com/isms/Submit.json;
- 请求方式:POST,请求头 Content-Type: application/x-www-form-urlencoded;
- 接收回执:在服务端提供一个地址接收平台推送,收到后返回 success;
- 测试号码:准备海外真实号码用于联调,测试通过后再切换生产。
接入后如何跟进
提交成功后返回流水号,回执推送会携带同一流水号,用于与业务订单关联。接入期间如有疑问,达信通提供接入支持,客户经理会跟进模板报备与参数配置。
咨询可拨打 400 118 6878。使用国际短信接口,把准备做在前面,接入过程会更省心。