开发者如何快速对接短信接口？代码示例方案

互亿无线短信接口支持 POST 与 GET，两种方式都能正常发送短信。编码格式统一为 UTF-8，开发环境无需任何复杂配置。接口请求地址为：https://api.ihuyi.com/sms/Submit.json。这是所有短信发送请求的入口地址，无论是验证码还是业务提醒，都通过这个接口完成提交。

请求头只需要一个固定值，开发者最关心“请求头要写什么？会不会很复杂？”

答案是不复杂，只需要一个固定值即可：Content-Type: application/x-www-form-urlencoded

按照普通表单提交的方式发送即可。

发送短信所需的核心参数

调用 Submit.json 涉及的字段并不多，但每个字段承担的作用很明确，只要理解这几个点，就能顺利完成对接。

1. account

这个字段对应你的 APIID，登录用户中心就能查看。发送短信时必须携带，它是身份标识之一。

2. password

可以使用 APIKEY，也可以使用动态密码。如果选动态密码，那么 time 字段会变成必填，用来校验时效性。

3. mobile

短信接收的手机号。支持发送长短信（500 字以内），系统会自动按照多条计费，不需要开发者做额外处理。

4. content 和 templateid

调用方式分为两种，你可以根据业务场景自由选择：

完整内容方式

这种方式适合你自己写好一段短信内容，不依赖模板。例如发送验证码，你可以直接提交完整文案：content=您的验证码是：1234。请不要把验证码泄露给其他人。

系统会按你提供的内容直接发送给用户。

模板变量方式

如果你想减少审核成本，提高发送效率，可以选择模板模式。模板中会出现多个变量位置，调用时只需按顺序把变量内容用竖线隔开。例如：content=20180515006|张三|136xxxxxxxx|100元

只要变量顺序一致，系统就会自动生成完整短信内容。这种方式非常适合订单类通知、账号信息提醒、服务状态更新等场景。

5. time（可选项）

只有在使用动态密码时需要填写。格式为 10 位 Unix 时间戳。

调用接口后返回什么？如何判断成功？

提交短信后，接口会返回一个 JSON 数据，用来说明提交状态。其中最关键的字段是 code，当它的值等于 2 时，表示短信已成功提交。另外还会返回一个 msg 作为描述，以及一个 smsid 字符串。你可以把 smsid 记录在数据库中，用于后续查询或业务追踪。

为什么这么多开发者会选择互亿无线的短信接口？

从开发者使用体验出发，最大优势是接入速度快。提交方式统一，接口稳定，不依赖任何复杂 SDK，复制示例代码即可跑通。同时模板变量模式能覆盖绝大多数业务场景，减少人工维护成本。只要会发 HTTP 请求，就能顺利完成短信发送，从调试到上线不需要太多门槛。