您的位置:首页 >  接口中心 > 彩信接口说明
  彩信接口说明
 

1 接口地址

正式地址:http://caixin.253.com/api/send

2 请求方式

POST

3 请求参数


参数名类型是否必填说明
account
String(50)客户账号 例:test
timestampString(10)时间戳,1970/1/1到现在的秒数,10位,100秒内请求有效
urlString(256)接口回调地址 
phonesString(11)发送手机号码(最多5百个号码) 例:18110000001,18110000002
titleString(20)彩信标题 例:彩信测试
msgString彩信内容(json字符串) 
ext_idString(50)商户系统订单号/流水号 例:20161212
signString(50)签名 


4 返回结果


参数名类型说明
codeString返回码:请求成功为1
descString提示信息
ext_idString商户系统订单号/流水号 与提交中一致原样返回


响应成功示例:

{"desc":"提交成功","code":"1","ext_id":"30201605302153191"}

响应失败示例:

{"desc":"签名错误","code":"-3","ext_id":"30201605302153191"}

此接口,是彩信发送后,彩信平台将发送结果推送到商户提供的URL,商户接收请求。注意:商户接收回调后,请返回字符串:”OK”。信息如下:

1 推送内容


参数名类型说明
codeString返回码:请求成功为1;错误码详见附页一
descString订单提交信息描述
ext_idString商户系统订单号
phoneString充值手机号码

2 示例

{ "code" : "0", "desc" :"充值成功", "ext_id" : "20150602103851791397" }


1 接口地址

正式地址:http://caixin.253.com/api/queryStatus

2 请求方式

POST

3 请求参数



参数名类型是否必填说明
accountString(50)客户账号 例:test
timestampString(10)时间戳,1970/1/1到现在的秒数,10位,100秒内请求有效
ext_idString(50)商户系统订单号/流水号 例:20161212
signString(50)签名



返回结果


参数名类型说明
codeString返回码:请求成功为1
descString提示信息
ext_idString商户系统订单号/流水号 与提交中一致原样返回
dataString标准json格式数据 code为1时有返回 格式参见说明

成功示例:

{"desc":"提交成功","code":"1","ext_id":"201202","data ":"{}"}

成功时data数据格式如下:

{
    "fail": [ // 失败号码数组
        "18117351529",
        "13817694185"
    ],
    "success": [ // 成功号码数组
        "18117351521",
        "13817694186"
    ]
}


失败示例

{"desc":"签名错误","code":"-3","ext_id":"30201605302153191"}
[{"code":"000099","desc":"充值中","ext_id":"30201605302153191"},{"code":"000099","desc":"充值中","ext_id":"30201605302153191"}]

参数为空或没有数据:[]


错误码说明解决方案
1提交成功 待发送
-1包含敏感词去除敏感词重新提交
-2时间戳超时同步服务器时间
-3签名错误检查签名后重试
-4余额不足充值后重试
-5黑名单号码问题
30发送成功
-30发送失败请联系客服人员处理
-50为空验证未通过检查必填参数是否为空
-51长度验证未通过检查参数长度
-52彩信内容不规范检查彩信内容格式
-53账号不存在或未启用更换账号后重试
-54ip验证未通过检查绑定ip
-55
内容总大小不能超过128k减少内容后重试
-99未知错误请联系客服人员处理


第一步:根据参数名称,按照ASCII升序拼接参数;最后拼接key(key为客户密码由彩信平台提供)。

示例:

account=1timestamp=1352665500url=http://www.baidu.com…key=abcdef

第二步:用MD5算法对拼接的字符串进行加密,生成签名。MD5 (string)后的结果就是sign的值(小写)