< 返回

短信接口开发文档

2026-01-14 04:43 作者:万载云 阅读量:3222
短信国际与国内短信接口开发文档(模拟版)

短信国际与国内短信接口开发文档

1. 接口说明

短信提供 HTTP API 接口,可实现国内短信与国际短信的发送、余额查询及接收回执。

所有接口均使用 UTF-8 编码,HTTP GET 请求方式。

2. 接口地址

接口类型 普通接口 安全接口(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 接收上行短信

3. 国内短信发送接口

接口地址

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

4. 国际短信发送接口

接口地址

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

5. 查询余额接口

接口地址

http://api.wanzaiyun.com/query?u=USERNAME&p=PASSWORD

返回示例

0
100,99

第一行为返回码 0 表示成功;第二行两个数字分别为:已发送条数,剩余条数。

6. 接收短信接口

接口地址

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 表示接收成功。

7. 编码规范

  • 统一使用 UTF-8 编码。
  • 短信内容 c 参数必须进行 URL 编码
  • 国际号码必须带 + 并进行 URL 编码。
  • HTTP 请求方式为 GET

8. 测试账号

本模拟环境提供测试账号:

  • 用户名:testuser
  • 密码:123456(MD5 值:827ccb0eea8a706c4c34a16891f84e7b
© 短信模接口文档
首页 产品中心 了解我们 个人中心
联系我们
返回顶部