2013年2月1日星期五

PHPCMS短信接口



更新时间:2012-6-1
版本:2.0
短信平台网站: http://sms.phpcms.cn/
所有接口同时支持get / post二种方式获取:
发送短信接口:
http://sms.phpcms.cn/api.php?op=sms_service&sms_uid=$sms_uid&sms_pid=$sms_pid&sms_passwd=$sms_passwd&mobile=$mobile&send_txt=".urlencode($send_txt)."&charset=".CHARSET 
2012.12.15日起,将使用新的发送短信接口:
http://sms.phpcms.cn/api.php?op=sms_service&sms_uid=$sms_uid&sms_pid=$sms_pid&sms_passwd=$sms_passwd&mobile=$mobile&send_txt=".urlencode($send_txt)."&charset=".CHARSET."&tplid=".$tplid
重点说明一下,新接口中$send_txt 和 $tplid 参数

参数
含义
备注
$send_txt
短信内容
新接口根据使用短信模版所包含的参数数量进行组合短信内容,举例如下:

短信模版样式
欢迎您:___,你的验证码是___,请于五分钟内完成验证!

$send_txt参数为:
小王||334466

也就是说将参数使用|| 符号连接起来传递。
$tplid
短信模版ID
可与网站后台发送短信处查看模版ID,具体请看图一所示。


正常返回结果:0#9573

#号前状态码,#号之后,返回短信平台的查询id

代码
说明
0
成功
1
手机号码非法
2
用户存在于黑名单列表
3
接入用户名或密码错误
4
产品代码不存在
5
IP非法
6
源号码错误
7
调用网关错误
8
消息长度超过60
9
发送短信内容参数为空
10
用户已主动暂停该业务
11
wap链接地址或域名非法


错误返回状态:
-1
单个号码每分钟发送短信数量超过限制3 
-2
API mobile phone error
-11
帐号验证失败
-10
SNDA接口没有返回结果
-12
剩余短信数不足以发送
-15
产品已停用
-16
因发垃圾信息该产品被停用
-17
内容包含敏感词
-18
全英文140,带中文60,长短信全英文420,长短信带中文180
-19
该运营商暂停短信发送
-20
自定义签名长度超过规定长度
-40
接口返回异常,请联系管理员
  
获取短信产品列表信息:
获取短信剩余条数: 
返回值:
正常,{"surplus":"987654","allow_send_ip":["192.168.1.2","114.251.167.194"]}
帐号验证失败返回:{"msg":"-1","tips":"验证失败"}

获取充值记录: 
最多返回:30条 
http://sms.phpcms.cn/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":"验证失败"} 
获取消费记录:
默认:返回20条记录
$page 当前分页
返回数组:tatal 总条数
列表:datas

没有评论:

发表评论