创瑞短信平台二次开发接口文档

2017-11-09    次访问   

1.1 短信接口分类

1、用户自写短信内容发送短信,适合:会员群发通知、会员营销群发等,有人工审核 ;

2、通过绑定短信模板发送短信,适合:验证码、订单短信等触发类短信,可以免审下发 ;

3、获取手机用户的短信上行。

1.2 短信接口主要功能

短信接口支持中国移动、中国联通、中国电信以及国内虚拟运营商所属的全国手机号码。国外手机可转至国际短信查看详情。

1.3 短信接口支持手机号码情况

√ 用户自写短信内容,适合:会员群发通知、 会员营销群发 等;

√ 单发或群发;

√ 支持行业及广告营销类内容;

√ 支持定时发送短信;

√ 小规模数量免审自动下发。

√ 无人工审核 。

1.4 短信接口请求方式

用户通过HTTP的POST方式提交短信发送请求。编码采用UTF-8编码。

1.5 短信提交地址

环境HTTP请求地址
正式环境联系客服获取接口请求地址

1.6 参数定义

序号参数说明
1name必填参数。用户账号
2pwd必填参数。(登陆web平台:基本资料中的接口密码)
3content必填参数。发送内容(1-500 个汉字,建议300字符内)UTF-8编码
4mobile必填参数。手机号码。多个以英文逗号隔开
5stime可选参数。(发送时间,填写时已填写的时间发送,不填时为当前时间发送,秒到)
6sign必填参数。用户签名。(建议联系销售进行后台绑定)
7type必填参数。固定值 pt
8extno可选参数,(扩展码,用户定义扩展码,只能为数字,如需要扩展不同签名,需要帮扩展的号码和对应的签名报给客服)

1.7 短信提交响应

用户短信通过http请求提交到服务器后,服务器返回响应码,响应码的格式如下:code,sendid,invalidcount,successcount,blackcount,msg

1.7.1格式说明

短信提交响应为英文逗号隔开的一行数据,状态,发送编号,无效号码数,成功提交数,黑名单数和消息,无论发送的号码是多少,一个发送请求只返回一个sendid,如果响应的状态不是"0",则只有状态和消息。

1.7.2示例

提交成功

0, 20140821110353234137876543,0,500,0,提交成功

20140821110353234137876543为返回的sendid,这个状态供报告匹配时使用。

1.7.3 响应状态值说明

代码说明
0提交成功
1含有敏感词汇
2含有敏感词汇
3没有号码
4包含sql语句
10账号不存在
11账号注销
12账号停用
13IP鉴权失败
14格式错误
-1系统异常



文章均为思乐科技专注网站建设,成都网站建设的成都网站建设公司原创,转载请注明来自https://www.cdsile.com/news/fuwudayi/2017119/77489.html