互亿无线流量API接口协议指南2.0.doc

互亿无线流量API接口协议指南 互亿无线流量 API 接口协议指南【For Http 版本 2.0】上海思锐信息技术有限公司2016年3月15日法律说明版权所有上海思锐信息技术有限公司。本文档包含的所有内容除特别声明之外，版权均属于上海思锐信息技术有限公司所有，思锐可在不作任何申明的情况下对本文档内容进行修改。本文档中所使用的商标所有权属于该商标的所有者。文件说明文件标识ihuyi_ll API当前版本2016_03_15 V2.0作者ihuyi_ll_Robert创建日期2016-05-10最新更新2016-03-15上海思锐信息技术有限公司电话：4008-808-898 021-5169-8929 185 2151 5089（非上班时段拨打）传真：021-3353 2189邮箱：地址：中国 上海 浦东新区 东方路1357号18C邮编：200127流量接口说明接口地址/api单号码充值流量请求(POST 或者GET)类型参数名称参数值描述参数actionrecharge参数username用户名(签名)参数package套餐数额(签名)参数timestamp时间戳(签名)参数sign签名返回值(JSON格式)命名类型描述codeint代码(1为提交成功)messagestring消息描述taskidstring任务id,提交失败则没有帐号余额查询请求(POST 或者GET)类型参数名称参数值描述参数actiongetbalance参数username用户名(签名)参数timestamp时间戳(签名)参数sign签名返回值(JSON格式)命名类型描述codeint代码messagestring消息描述balancefloat剩余余额充值状态查询请求(POST 或者GET)类型参数名称参数值描述参数actiongetreports参数username用户名(签名)参数count一次取数量(签名)参数timestamp时间戳(签名)参数sign签名返回值(JSON格式)命名类型描述codeint代码(1为提交成功)messagestring消息描述reports+array报告 taskidstring任务id mobilestring手机号码 stateint状态(0失败, 1成功) messagestring消息注意:状态获取后服务器则会删除状态获取流量包档位请求(POST 或者GET)类型参数名称参数值描述参数actiongetpackages参数username用户名(签名)参数timestamp时间戳(签名)参数sign签名返回值(JSON格式)命名类型描述codeint代码messagestring消息描述packages+float套餐 typestring类型(cncm:中国移动 cncu:中国联通 cnct:中国电信) namestring流量包 numberint数值(用于充值请求) stateint状态(1启用,0未启用) priceint单价状态码数值描述0未知错误1提交成功1000无此操作类型(action为空或不存在)1001用户名为空1002用户名错误1003手机号码为空1004手机号码为空1005套餐不能为空1006时间戳不能为空1007不存在的套餐1008签名不能为空1009签名错误1010签名过期1011账号被冻结1012余额不足1013访问ip与备案ip不相同2001不支持的手机号码2002手机号码已加入黑名单2003不支持的地区3001扣费失败4001系统内部故障签名说明需要把apikey(登录系统获取)放到要签名的键值对中，按照asc排序键值对参数名排序，拼接键值对字符串(参数名小写)，再用32位md5加密如:sign=md5(aaaa=aaaa&bbbb=bbbb&cccc=cccc&dddd=dddd)PHP充值签名代码如下:$sign = md5(sprintf(apikey=%s&mobile=%s&package=%s×tamp=%s&username=%s, $apikey, $mobile, $package, time(), $username);GET方式地址如:/api?action=recharge&username=t