当前位置：帮助文档 > > 正文

短信通 API 接口说明文档

请仔细阅读接口文档

## 发送短信接口：
#### 接口1:
```
http://sms.phpip.com/api.php?op=sms_service_new&sms_uid=【$sms_uid】&sms_pid=【$sms_pid】&sms_passwd=【$sms_passwd】&charset=gbk&send_txt=12334&mobile=18900000000&tplid=1
```

#### 新接口2：

```
http://sms.phpip.com/api.php?op=sms_service_vip&sms_uid=【$sms_uid】&sms_pid=【$sms_pid】&sms_passwd=【$sms_passwd】&charset=gbk&send_txt=12334&mobile=18900000000&tplid=1
```

> send_txt 发送的内容：

多个变量用 || 分开，如：send_txt＝变量A||变量B，通过urlencode转义中文。如：send_txt＝urlencode(变量A||变量B)

> mobile 手机号

> tplid 短信模版id，默认1，验证码模版

---

##### 接口调试：在连接地址后面增加：&test=yes

---

> 返回完整的发送短信内容。

```
如：您的验证码是：12334，有效期为10分钟。如非本人操作，可不用理会。回复TD退订。【短信提醒】
```

### 获取短信产品列表信息：

```
http://sms.phpip.com/api.php?op=sms_get_productlist&sms_uid=【$sms_uid】&sms_pid=【$sms_pid】&sms_passwd=【$sms_passwd】
```
### 获取短信剩余条数：

```
http://sms.phpip.com/api.php?op=sms_get_info&sms_uid=【$sms_uid】&sms_pid=【$sms_pid】&sms_passwd=【$sms_passwd】
```

#### 返回值：

正常，
```
{"surplus":"987654","allow_send_ip":["192.168.1.2","114.251.167.194"]}
```
帐号验证失败返回，

```
{"msg":"-1","tips":"验证失败"}
```

### 获取充值记录：

最多返回：30条

```
http://sms.phpip.com/api.php?op=sms_get_paylist&sms_uid=【$sms_uid】&sms_pid=【$sms_pid】&sms_passwd=【$sms_passwd】
```

#### 返回值：

正常，

```
0 =>array(

'productid'=> 1,

'price'=> 10,

'totalnum'=> 100,

'name'=>'10元套餐',

'give_away'=>0,

'description'=>'充50元送10条短信',

'recharge_time'=>'2121212121',

),
```

帐号验证失败返回：

```
{"msg":"-1","tips":"验证失败"}

```

### 获取消费记录：

```
http://sms.phpip.com/api.php?op=sms_get_report&sms_uid=【$sms_uid】&sms_pid=【$sms_pid】&sms_passwd=【$sms_passwd】&page=$page
```

> 默认：返回20条记录
> 
> $page 当前分页
> 
> 返回数组：tatal 总条数
> 
> 列表：datas

## 接口返回值说明：

```
'0'=>'发送成功',

'1'=>'手机号码非法',

'2'=>'用户存在于黑名单列表',

'3'=>'接入用户名或密码错误',

'4'=>'产品代码不存在',

'5'=>'IP非法',

'6 '=>'源号码错误',

'7'=>'调用网关错误',

'8'=>'消息长度超过60',

'9'=>'发送短信内容参数为空',

'10'=>'用户已主动暂停该业务',

'11'=>'wap链接地址或域名非法',

'12'=>'5分钟内给同一个号码发送短信超过10条',

'13'=>'短信模版ID为空',

'14'=>'禁止发送该消息',

'-1'=>'每分钟发给该手机号的短信数不能超过3条',

'-2'=>'手机号码错误',

'-11'=>'帐号验证失败',

'-10'=>'接口没有返回结果',

'-12'=>'剩余条数为0',

```

### 其他说明：

### 程序中返回的状态信息：
> 下面的都需要检查自己的程序问题，并非接口错误

```
－3 当日单IP 超过最大限制，默认10条

－99 短信接口关闭

－100 验证码错误

－1 当日该手机号发送短信数量超过限制，默认3条
```

## 可用的短信模版

```
1---您的验证码是：##NUM##，有效期为10分钟。如非本人操作，可不用理会。回复TD退订。
13---尊敬的用户您好，您在##MD5##的注册验证码为：##NUM##，验证码有效期为5分钟。回复TD退订。
2---尊敬的用户您好，您在尝试通过手机验证找回密码，验证码为：##NUM##，请勿将验证码转告他人。回复TD退订。
170---您的验证码是：##NL##，有效期为10分钟。如非本人操作，可不用理会。回复TD退订。
3---尊敬的客户，您的订单（##NUM##）已出库发货，正在配送中，请您耐心等待。回复TD退订。
178---尊敬的客户：因系统升级，【##MD5##】将在##DATE## ##11:00:00##至##12:00:00##期间停止运行！请您提前做好安排！
5---尊敬的客户，您通过密码找回功能已经重置了密码，新密码为：##NL##。为了您的账号安全，请登录后及时修改密码。回复TD退订。
223---正在找回密码，您的验证码是##NL##
224---亲爱的##A10##，您的验证码是##NUM##。如非本人操作，请忽略本短信
225---亲爱的用户，您的帐号正在申请更换绑定手机号操作，验证码为##NUM##，如果非本人操作，请妥善保管您的验证码
226---您已注册成功，活动现场签到注册码为##NUM##，请留存此短信现场签到使用，感谢您的参与！
227---亲爱的##A10##，今天是您的生日，祝您生日快乐，生活幸福
228---天增岁月人增寿，春满乾坤福满门。三羊开泰送吉祥，五福临门财源茂。恭祝新春快乐，平安幸福，合家欢乐！
229---一个梦想在羊年飞翔，激励人们奋勇向前；一道彩虹在羊年高挂，带给人们好运连连；一种幸福在羊年降临，送给人们无尽欢畅；一生祝福在羊年徜徉，给予人们万千温暖。羊年快乐！
230---捕捉商机，让羊年飘荡成功的味道；绘制蓝图，让羊年沐浴梦想的光华；绽放微笑，让羊年踏入幸福的坦途；发送祝福，让羊年收获温暖的情意。羊年的到了，愿你的生活美好灿烂！
231---亲爱的##A10##：您正在进行账户基本信息维护，请在校验码输入框输入：##NL##，以完成操作
232---故障报警：尊敬的用户，##IP##服务器无法访问，请核实。
233---故障恢复：尊敬的用户，##IP##服务器恢复访问。
234---故障报警：尊敬的用户，##IP##服务器Mysql无法链接，请核实。
235---故障恢复：尊敬的用户，##IP##服务器Mysql恢复正常。
236---尊敬的客户，您的外卖订单已经确认，请耐心等待。
237---尊敬的用户，您已成功注册为本站会员，感谢您的加入。
```

## 模版参数说明

| 参数  | 说明  |  例子 |
| ------------ | ------------ | ------------ |
| ##IP##  | IP地址  |8.8.8.8   |
| ##A10##  |10个字符，不区分中英文|  例如，姓名：楷书 |
| ##A15##  |15个字符，不区分中英文|  例如，姓名：楷书 |
| ##NUM##  |数字，不限长度| 012345 |
| ##NL##  |数字+字母，不限长度| abc123 |
| ##N1##  |数字，不限长度| 012345 |
| ##N2##  |数字，不限长度| 012345 |
| ##N3##  |数字，不限长度| 012345 |
| ##N4##  |数字，不限长度| 012345 |
| ##N1##  |数字，不限长度| 012345 |

上一页：五指cms整合discuz x3 下一页：常见问题

短信通 API 接口 说明文档

短信通 API 接口说明文档