基本说明
一、接口列表
| 接口名称 | 适用场景 | 请求地址(返回格式选择) | 请求方式 |
|---|---|---|---|
| 单发接口 | 验证类短信、通知类短信 | http://sms-api.luosimao.com/v1/send.[格式] | POST |
| 批量接口 | 通知类短信、商业推广类短信 | http://sms-api.luosimao.com/v1/send_batch.[格式] | POST |
| 余额查询接口 | 账户余额查询 | http://sms-api.luosimao.com/v1/status.[格式] | GET |
所有接口URL中的 [格式] 需替换为实际需要的返回格式标识符:
- JSON 格式:替换为
json(示例:/v1/send.json) - XML 格式:替换为
xml(示例:/v1/send.xml)
二、接口规范
1.编码要求
- 统一使用 UTF-8 编码格式
- 需确保请求参数符合编码规范
2.身份验证
- 认证方式:
HTTP Basic Auth - 认证凭证:
- 用户名:
api(这里为固定值) - 密码:
API Key(在管理平台获取)
- 用户名:
3.返回格式
- 通过URL后缀动态指定返回格式(
.json或.xml) - 示例:
/v1/send.json返回JSON格式数据
4.请求头设置
所有的 Content-Type 请求头请设置为 Content-Type: application/x-www-form-urlencoded
三、安全管理
1.API Key获取
登录管理控制台,进入【短信服务】→【触发发送】,查看/更换API Key
2.IP白名单设置
登录管理控制台,进入【短信服务】→【IP白名单】,将您认可的服务器IP地址填写到白名单中,强烈建议您在任何时候都设置IP白名单,保护接口安全。