短信通知API接口文档用于指导开发者通过 HTTP 协议调用互亿无线的短信服务接口,实现短信通知发送、余额查询、回执推送等功能。
一、接口总览
- 接口类型:短信单条发送、批量发送、余额查询、回执推送、上行回复推送、模板提交与删除。
- 请求方式:支持 GET 和 POST 提交,建议使用 HTTPS。
- 加密方式:采用 MD5 动态签名 + HTTPS 协议保障数据安全。
- 身份认证:需使用平台获取的 API ID 和 API KEY。
二、核心功能简述
1. 短信发送
单条发送接口:支持 POST/GET 请求,支持自定义短信内容与签名,发送结果实时返回。
批量发送接口:支持最多 5000 个手机号一次提交,可选择模板或变量内容自动匹配。
2. 余额查询
提供短信条数查询接口,可实时获取账户剩余短信量,支持 XML 或 JSON 格式响应。
3. 回执推送
支持回执状态自动推送,用户需提供接收地址,接收成功需返回 "success" 字符。
4. 上行回复推送
支持接收用户回复的短信内容,用于互动场景,推送方式同回执。
5. 模板管理
- 提交模板:可通过接口提交短信模板,需指定内容、类型和使用场景,提交后等待审核。
- 删除模板:支持通过模板 ID 删除已提交模板。
- 审核状态推送:模板审核结果会以 POST 推送方式通知开发者。
三、模板与签名规范
- 短信模板:必须使用平台审核通过的格式,变量部分用【变量】标识。
- 短信签名:每条短信内容必须包含签名(如【互亿无线】),未认证账号仅限使用默认签名。
下载语音通知API接口文档