《云之讯流量充值协议.doc》由会员分享，可在线阅读，更多相关《云之讯流量充值协议.doc（11页珍藏版）》请在三一文库上搜索。
1、 云之讯流量充值协议目录1.请求和响应报文.32.API 请求地址.33.消息单元定义.33.1.单号码充流量 .33.2.批量充流量 .43.3.卡密充流量 .43.4.获取流量包定义 .53.5.查询余额 .63.6.查询状态 .63.7.推送状态 .74.错误定义.85.签名算法.81. 请求和响应报文接口采用 http 进行交互，所有提交参数均需要 UTF-8 的 urlencode 编码后传输，支持 GET 和POST 方式提交(数据量大则建议采用 POST)。返回报文统一使用 JSON，编码为 UTF-8，报文中某个可选参数的值为空，则该标签可以不出现。请接入用户登录到平台在用户基
2、本信息页获取 ApiKey标注 (签名) 的参数需要对其进行签名校验，签名算法参见文档尾2.API 请求地址http:/ 固定值Range流量类型0 全国流量 1 省内流量，不带改参数时默认为 0OutTradeNo商户订单号商户系统内部的订单号,64 个字符内、可包含字母，可为空Account帐号 (签名)Mobile号码 (签名)Package套餐 (签名)流量包大小(必须在返回流量包选择内)Sign签名参见签名算法响应TaskID任务编码 失败为空Code代码Message消息例:http:/ 固定值Range流量类型0 全国流量 1 省内流量，不带改参数时默认为 0OutTradeNo
3、商户订单号商户系统内部的订单号,64 个字符内、可包含字母，可为空Account帐号 (签名)Mobile号码 (签名)Package套餐 (签名)流量包大小(必须在返回流量包选择内)Sign签名参见签名算法响应TaskID任务编码 失败为空Code代码Message消息例:http:/ 64 个字符012非法 IP 地址请求013账号已经失效014账号已经暂停015账号设置 IP 接入限制016CP 订单号重复错误017运营商套餐包非法3.3.批量充流量请求Action命令chargeBatV版本号1.1 固定值Range流量类型0 全国流量 1 省内流量，不带改参数时默认为 0OutTra
4、deNo商户订单号商户系统内部的订单号,64 个字符内、可包含字母，可为空Account帐号(签名)CMPackage移动套餐(签名)如有移动号码则必传 传值参考 getPackage 返回参数CUPackage联通套餐(签名)如有联通号码则必传 传值参考 getPackage 返回参数CTPackage电信套餐(签名)如有电信号码则必传 传值参考 getPackage 返回参数Mobile号码(签名)半角逗号(,)分割Sign签名参见签名算法响应TaskID任务编码失败为空Code代码Message消息例:http:/ 固定值Account帐号(签名)Mobile号码(签名)CardNo卡号
5、(签名)Password卡密(签名)Sign签名参见签名算法响应TaskID任务编码失败为空Code代码Message消息例:http:/ 固定值Account帐号(签名)Type类型(签名)0:不指定, 1:移动, 2:联通, 3:电信Sign签名参见签名算法响应Code代码Message消息Packages +返回流量包 Package流量包 Name名称 Price价格例:http:/ 固定值Account帐号(签名)Sign签名参见签名算法响应Code代码Message消息Balance余额例:http:/ getReportsV版本号 1.1 固定值Account帐号(签名)Coun
6、t一次取数量(签名)Sign签名参见签名算法响应Code代码Message消息 Reports+返回记录 TaskID任务 Mobile手机 Status状态 4.状态成功, 5.状态失败 ReportTime时间 ReportCode代码说明 OutTradeNo商户订单号商户系统内部的订单号例:http:/ 建议获取到状态后先记录一个日志3.8.推送状态推送状态接口用户提供接收 http post 推送的 url 地址。接收到推送数据解析成功后响应 ok，即为推送成功，否则尝试三次。若报告推送 1 小时未成功，则丢弃。推送数据格式为 json 数组。请求 http post 或者 get
7、TaskID任务 Mobile手机 Status状态 4.状态成功, 5.状态失败 ReportTime时间 ReportCode代码说明 OutTradeNo商户订单号商户系统内部的订单号响应ok 为成功，其他则失败。HTTP GET 方式回调 key value 格式数据（数据会先被 utf-8 urlencode，且一次只会回调一条订单状态）。如：url?TaskID=3368382&Mobile=13411989319&Status=4&ReportTime=2015-12-21+23%3a08%3a14&ReportCode=4%ef%bc%9a%e6
8、%88%90%e5%8a%9f%ef%bc%9a%e6%88%90%e5%8a%9f&OutTradeNo=4793558HTTP POST 方式回调 json 格式数据，以数据流方式 post（存在多条订单状态的情况）。如：TaskID:3,Mobile:13789679619,Status:5,ReportTime:2015-06-24T15:52:54.73,ReportCode:S:终止,TaskID:4,Mobile:13789679618,Status:4,ReportTime:2015-06-24T16:32:35.583,ReportCode:成功3.9.根据 CP 订
9、单号查询订单请求Action命令getOrderV版本号 1.1 固定值Account帐号(签名)OutTradeNo商户订单号（签名）商户系统内部的订单号,64 个字符内、可包含字母，可为空Sign签名参见签名算法响应Code代码Message消息Data返回数据 TaskID任务 ID Mobile手机 Status状态 4.状态成功, 5.状态失败 6.处理中 ReportTime充值完成时间 ReportCode状态说明 OutTradeNo商户订单号商户系统内部的订单号例:http:/ 订单号&sign=MD53.10. 查询手机号码归属请求Action命令getMobile
10、InfoV版本号 1.1 固定值Account帐号(签名)mobile手机号码（签名）Sign签名参见签名算法响应Code代码Message消息Data返回数据 Mobile手机号码 OperatorName运营商名称广东移动全球通 Operator归属运营商YD：移动;DX：电信;LT：联通 OperatorCode运营商代码GMCC Province归属省份广东 City归属城市深圳 AreaCode地区编码例:http:/ asc 排序键值对参数名排序，拼接键值对字符串(参数名小写) ，需要把 api key 放到要签名的键值对最后。例如 sign=MD5(aaaa=aaaa&b
11、bbb=bbbb&cccc=cccc&dddd=dddd&key=api 密钥)用 32 位 MD5 加密，生成的 MD5 小写 var account = ; var mobile = ; var package = ; var key = ; /基本参数 var action = charge; var ver = 1.1; var host = http:/; var page = 0/api.aspx?action=1&v=2&3&sign=4; /协议参数 var reqParams = new Dictionary(); reqPar
12、ams.Add(account, account); reqParams.Add(mobile, mobile); reqParams.Add(package, package); /参数排序 var orderedParams = reqParams.OrderBy(p = p.Key).ToDictionary(p = p.Key, p = p.Value); /参数拼接 var strParam = ; foreach (var item in orderedParams) strParam += item.Key.ToLower() + = + item.Value.ToString(
13、) + & strParam = strParam.Trim(&); /构造 URL var url = string.Format(page, host, action, ver, strParam, GetMD5(strParam + &key= + key); /请求 var client = new WebClient(); client.Encoding = Encoding.UTF8; var result = client.DownloadString(url); /与 ASP 兼容的 MD5 加密算法 public static string GetMD5(string s) MD5 md5 = new MD5CryptoServiceProvider(); byte t = md5.ComputeHash(Encoding.GetEncoding(utf-8).GetBytes(s); StringBuilder sb = new StringBuilder(32); for (int i = 0; i t.Length; i+) sb.Append(ti.ToString(x).PadLeft(2, 0); return sb.ToString();