1 简介
本系统是本司自主研发的系统,用于实现终端客户短信/彩信发送的管理平台,本文档为第三方平台使用API接口,与本短信平台进行对接而完成。本接口提供了HTTP实现方式。对于采用HTTP协议的用户,出于数据安全性和数据容量的考虑,建议采用http中的Post方法连接Api地址进行数据传输。
2 缩率语
客户端:本文中特指企业客户侧系统。
服务端:本文中特指本司系统。
3 发送接口
提交地址:请联系销售提供
接口提交方式:GET/POST
功能:普通群发
参数名称 |
说明 |
备注 |
userid |
用户名 |
|
pwd |
密码 |
此处用原始密码做MD5加密,32位大写格式 |
mobile |
手机号 |
多个用英文逗号隔开 |
msgfmt |
编码类型 |
如果不填默认为GBK,可以选填GBK或者utf8 |
content |
内容 |
做base64加密操作,编码方式使用msgfmt中的方式,如果msgfmt有值的话,默认gbk |
ext |
扩展 |
如果需要 |
msgid |
唯一标识 |
选填,如果不填系统自动生成作为当前批次的唯一标识 |
attime |
定时时间 |
选填,格式:2008-06-09 12:00:00 |
encodeType |
加密方式 |
此处填为base64,注意小写,内容的编码方式也随之使用base64方式 |
返回值说明:提交成功,返回当前提交数据的唯一标记ID
4 个性短信发送
提交地址:请联系销售提供
接口提交方式:GET/POST
功能:针对不同号码不同内容群发
参数名称 |
说明 |
备注 |
userid |
用户名 |
|
pwd |
密码 |
此处用原始密码MD5加密,32位大写格式 |
mobile |
手机号 |
多个用英文逗号隔开 |
msgfmt |
编码类型 |
如果不填默认为GBK,可以选填GBK或者UTF8 |
content |
内容 |
做base64加密操作,编码方式使用msgfmt中的方式,如果msgfmt有值的话,内容之间用逗号隔开,内容个数需要与手机号个数相等。 |
ext |
扩展 |
如果需要 |
attime |
定时时间 |
选填,格式:2008-06-09 12:00:00 |
encodeType |
加密方式 |
此处填为base64,注意小写,内容的编码方式也随之使用base64方式 |
返回值说明:提交成功,返回当前提交数据的唯一标记ID
5 查询余额
提交地址:请联系销售提供
接口提交方式:GET/POST
功能:查询余额
参数名称 |
说明 |
备注 |
userid |
用户名 |
|
pwd |
密码 |
此处用原始做MD5加密,32位大写格式 |
返回值说明:成功返回当前账户余额。
返回值 |
返回值说明 |
-2 |
参数不能为空 |
-3 |
账户信息验证不通过 |
-4 |
余额不足 |
-5 |
参数格式不正确(内容解析异常) |
-6 |
内容太长 |
-8 |
扩展长度不正确 |
-9 |
ip验证不正确 |
-10 |
时间不正确 |
-11 |
消息id过长 |
-990 |
未知异常 |