短信API文档
短信API文档是企业通信服务领域的重要资料,为开发者提供短信接口调用的详细说明,涵盖参数定义、请求方式、返回格式等内容,助力企业实现短信验证码、通知等功能自动化发送。
基本定义
短信API文档是用于指导开发者如何使用短信API接口的技术文档。通过该文档,开发者能够了解接口的具体调用方式、参数设置、返回结果等信息,从而实现短信的自动化发送。
核心技术参数
| 参数名称 | 参数值描述 | 示例 | 类型 | 必填 |
| account | APIID(用户中心【文本短信】-【验证码/通知短信】-【产品总览】查看) | xxxxxxxx | string | 是 |
| password | 1、APIKEY(用户中心【文本短信】-【验证码/通知短信】-【产品总览】查看);2、动态密码(生成动态密码方式请看该文档末尾的说明) | xxxxxxxxx | string | 是 |
| mobile | 根据发送方式不同:1、完整内容方式,提交完整的短信内容;2、模板变量方式,模板中的变量内容,多个变量以英文竖线(|)隔开。支持500字以内的长短信,长短信按多条计费 | 136xxxxxxxx | string | 是 |
| content | 短信内容,注:模板ID为空时必填 | 您的验证码是:1234。请不要把验证码泄露给其他人。 | string | 否 |
| templateid | 短信模板ID(使用模板变量方式发送时必填),调试阶段可使用系统默认模板ID:1 | 1 | string | 否 |
| time | Unix时间戳(10位整型数字,当使用动态密码方式时为必填) | 1623643787 | string | 否 |
核心功能
短信单条发送
请求支持POST和GET两种方法,字符编码为utf - 8,支持全天24小时发送。请求地址为https://api.ihuyi.com/sms/Submit.json 。
接入流程
发送短信
使用已审核通过的短信签名和模板组合短信内容,向目标用户发送。建议初期使用三大运营商手机号,少量多次测试发送效果,确保稳定性。
查询发送详情
登录平台控制台,可实时查询短信发送的状态、时间、数量等详情,便于监控业务效果与排查问题。
设置预警
为保障业务稳定与资金安全,建议设置联系人并配置验证码防盗刷预警、余量预警、短信发送量预警、短信发送频率预警。
适用场景
适用于企业的验证码通知、订单提醒、活动通知等场景,为企业与用户之间的信息传递提供支持。
避坑指南
短信内容需符合规范,不得包含违法违规、营销推广等内容。变量规范方面,验证码模板每个变量最多支持6位纯数字,通知短信每个变量取值长度不得超过80个字符。
FAQ
问:短信单条发送支持哪些请求方法?
答:请求支持POST和GET两种方法,字符编码为utf - 8。
问:模板ID有什么作用?
答:使用模板变量方式发送时,模板ID为必填项,调试阶段可使用系统默认模板ID:1。
互亿无线提供的短信API文档,为企业在通信服务领域提供了详细的技术指导,助力企业高效实现短信相关功能。
