云之讯流量充值协议.docVIP

云之讯流量充值协议  目录 1. 请求和响应报文 3 2. API请求地址 3 3. 消息单元定义 3 3.1. 单号码充流量 3 3.2. 批量充流量 4 3.3. 卡密充流量 4 3.4. 获取流量包定义 5 3.5. 查询余额 6 3.6. 查询状态 6 3.7. 推送状态 7 4. 错误定义 8 5. 签名算法 8 请求和响应报文 接口采用http进行交互，所有提交参数均需要UTF-8的urlencode编码后传输，支持GET和POST方式提交(数据量大则建议采用POST)。 返回报文统一使用JSON，编码为UTF-8，报文中某个可选参数的值为空，则该标签可以不出现。 请接入用户登录到平台在用户基本信息页获取 ApiKey 标注 (签名) 的参数需要对其进行签名校验，签名算法参见文档尾 API请求地址 /flux/api.aspx 消息单元定义 单号码充流量 请求 Action 命令 charge V 版本号 1.1 固定值 Range 流量类型 0 全国流量 1省内流量，不带改参数时默认为0 OutTradeNo 商户订单号 商户系统内部的订单号,64个字符内、可包含字母，可为空 Account 帐号 (签名) Mobile 号码 (签名) Package 套餐 (签名) 流量包大小(必须在返回流量包选择内) Sign 签名 参见签名算法 响应 TaskID 任务编码 失败为空 Code 代码 Message 消息 例:/api.aspx?v=1.1&action=charge&account=帐号&mobile=手机号&package=100&sign=MD5 单号码充流量（推荐，详细错误码） 请求 Action 命令 flowRecharge V 版本号 1.1 固定值 Range 流量类型 0 全国流量 1省内流量，不带改参数时默认为0 OutTradeNo 商户订单号 商户系统内部的订单号,64个字符内、可包含字母，可为空 Account 帐号 (签名) Mobile 号码 (签名) Package 套餐 (签名) 流量包大小(必须在返回流量包选择内) Sign 签名 参见签名算法 响应 TaskID 任务编码 失败为空 Code 代码 Message 消息 例:/api.aspx?v=1.1&action=charge&account=帐号&mobile=手机号&package=100&sign=MD5 增加错误码 011 商户订单号超过长度限制64个字符 012 非法IP地址请求 013 账号已经失效 014 账号已经暂停 015 账号设置IP接入限制 016 CP订单号重复错误 017 运营商套餐包非法 批量充流量 请求 Action 命令 chargeBat V 版本号 1.1 固定值 Range 流量类型 0 全国流量 1省内流量，不带改参数时默认为0 OutTradeNo 商户订单号 商户系统内部的订单号,64个字符内、可包含字母，可为空 Account 帐号(签名) CMPackage 移动套餐(签名) 如有移动号码则必传 传值参考getPackage返回参数 CUPackage 联通套餐(签名) 如有联通号码则必传 传值参考getPackage返回参数 CTPackage 电信套餐(签名) 如有电信号码则必传 传值参考getPackage返回参数 Mobile 号码(签名) 半角逗号(,)分割 Sign 签名 参见签名算法 响应 TaskID 任务编码 失败为空 Code 代码 Message 消息 例:/api.aspx?v=1.1&action=chargeBat&account=帐号&mobile=手机号逗号分割&cmPackage=100&cuPackage=100&ctPackage=100&sign=MD5 卡密充流量 请求 Action 命令 chargeCard V 版本号 1.1 固定值 Account 帐号(签名) Mobile 号码(签名) CardNo 卡号(签名) Password 卡密(签名) Sign 签名 参见签名算法 响应 TaskID 任务编码 失败为空 Code 代码 Message 消息 例:/api.aspx?v=1.1&action=chargeCard&account=帐号&mobile=手机号&cardNo=卡号&pssword=密码&sign=MD5 获取流量包定义 请