短信提供 HTTP API 接口,可实现国内短信与国际短信的发送、余额查询及接收回执。
所有接口均使用 UTF-8 编码,HTTP GET 请求方式。
| 接口类型 | 普通接口 | 安全接口(HTTPS) | 说明 |
|---|---|---|---|
| 国内短信 | http://api.wanzaiyun.com/sms |
https://api.wanzaiyun.com/sms |
发送国内短信 |
| 国际短信 | http://api.wanzaiyun.com/wsms |
https://api.wanzaiyun.com/wsms |
发送国际短信 |
| 查询余额 | http://api.wanzaiyun.com/query |
https://api.wanzaiyun.com/query |
查询账户余额 |
| 接收短信推送 | http://api.wanzaiyun.com/receive |
接收上行短信 | |
http://api.wanzaiyun.com/sms?u=USERNAME&p=PASSWORD&m=PHONE&c=CONTENT
| 参数名 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|
| u | 是 | tom | 在短信平台注册的用户名 |
| p | 是 | 9b11127a9701975c734b8aee81ee3526 | 密码经MD5加密后的32位小写字符串 |
| m | 是 | 13800138000 | 接收手机号,多个号码以逗号分隔 |
| c | 是 | %E3%80%90%E7%9F%AD%E4%BF%A1%E5%AE%9D%E3%80%91... | 短信内容,需UTF-8 URL编码 |
接口返回字符串。返回 0 表示发送成功,其它为错误代码。
| 返回码 | 说明 |
|---|---|
| 0 | 短信发送成功 |
| 30 | 错误密码 |
| 40 | 账号不存在 |
| 41 | 余额不足 |
| 43 | IP地址限制 |
| 50 | 内容含有敏感词 |
| 51 | 手机号码不正确 |
GET http://api.wanzaiyun.com/sms?u=testuser&p=827ccb0eea8a706c4c34a16891f84e7b&m=13800138000&c=%E3%80%90Test%E3%80%91%E6%82%A8%E7%9A%84%E9%AA%8C%E8%AF%81%E7%A0%81%E6%98%AF1234
http://api.wanzaiyun.com/wsms?u=USERNAME&p=PASSWORD&m=PHONE&c=CONTENT
| 参数名 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|
| u | 是 | tom | 用户名 |
| p | 是 | 9b11127a9701975c734b8aee81ee3526 | 密码MD5后值或API Key |
| m | 是 | %2B60901234567 | 接收手机号(国际号码需带+并URL编码) |
| c | 是 | %E3%80%90SMSBao%E3%80%91Your%20code%20is%204564 | 短信内容 UTF-8 URL编码 |
返回规则与国内短信完全一致。
GET http://api.wanzaiyun.com/wsms?u=testuser&p=827ccb0eea8a706c4c34a16891f84e7b&m=%2B60123456789&c=%E3%80%90SMSBao%E3%80%91Your%20code%20is%201234
http://api.wanzaiyun.com/query?u=USERNAME&p=PASSWORD
0 100,99
第一行为返回码 0 表示成功;第二行两个数字分别为:已发送条数,剩余条数。
http://api.wanzaiyun.com/receive?m=PHONE&c=CONTENT
| 参数名 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|
| m | 是 | 13800138000 | 回复手机号 |
| c | 是 | %E6%82%A8%E7%9A%84%E9%AA%8C%E8%AF%81%E7%A0%81%E6%98%AF4564 | 回复内容(URL编码) |
返回字符串 0 表示接收成功。
c 参数必须进行 URL 编码。+ 并进行 URL 编码。GET。本模拟环境提供测试账号:
testuser123456(MD5 值:827ccb0eea8a706c4c34a16891f84e7b)