互亿无线话费api接口协议指南1.3

《互亿无线话费api接口协议指南1.3》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、互亿无线话费API接口协议指南互亿无线话费API接口协议指南【ForHttp版本1.3】上海思锐信息技术有限公司2016年10月28日互亿无线话费API接口协议指南互亿无线话费API接口协议指南法律说明版权所有上海思锐信息技术有限公司。本文档包含的所有内容除特别声明之外，版权均属于上海思锐信息技术有限公司所有，思锐可在不作任何申明的情况下对本文档内容进行修改。本文档中所使用的商标所有权属于该商标的所有者。文件说明文件标识Ihuyi_LLAPI当前版本2016_11_28V1.3作者iHuyi_LL_Robert创建日期2015-09-17最新更新2016-1

2、1-28本次更新内容编号修改内容修改人修改日期1部分文字调整郑荣华2016-11-28上海思锐信息技术有限公司电话：4008-808-898021-5169-892918521515089（非上班时段拨打）传真：021-33532189邮箱：info@ihuyi.com地址：中国上海浦东新区东方路1357号18C互亿无线话费API接口协议指南邮编：200127互亿无线话费API接口协议指南话费接口说明接口地址http://f.ihuyi.com/phone  1.单号码充值话费请求(POST或者GET)类型参数名称参数值描述参数actionrecharge参

3、数username用户名(签名)参数mobile手机号码(签名)参数package套餐数额(签名)参数orderid订单ID(签名)参数timestamp时间戳(签名)格式如:yyyyMMddHHmmss允许10分钟统一以东8时间参数sign签名 返回值(JSON格式)命名类型描述codeint代码(1为提交成功)messagestring消息描述taskidstring任务id,提交失败则没有互亿无线话费API接口协议指南  2.帐号余额查询请求(POST或者GET)类型参数名称参数值描述参数actiongetbalance参数username用户名(签名

4、)参数timestamp时间戳(签名)格式如:yyyyMMddHHmmss允许10分钟统一以东8时间参数sign签名 返回值(JSON格式)命名类型描述codeint代码messagestring消息描述balancefloat剩余余额   3.充值状态查询请求(POST或者GET)类型参数名称参数值描述参数actiongetreports互亿无线话费API接口协议指南参数username用户名(签名)参数count一次取数量(签名)参数timestamp时间戳(签名)格式如:yyyyMMddHHmmss允许10分钟统一以东8时间参数sign签名 返回值(J

5、SON格式)命名类型描述codeint代码(1为提交成功)messagestring消息描述reports+array报告taskidstring任务idmobilestring手机号码stateint状态(0失败,1成功)messagestring消息 注意:状态获取后服务器则会删除状态 4.充值状态推送请求(POST方式推送到配置的网址)类型参数名称参数值描述互亿无线话费API接口协议指南参数taskid充值任务ID参数mobile手机号码(签名)参数state状态(签名)1:成功2:失败参数message消息(签名)参数sign签名 注意:充值状态查询

6、和充值状态推送两种方式只能选择其中一种 5.获取话费包档位请求(POST或者GET)类型参数名称参数值描述参数actiongetpackages参数username用户名(签名)参数timestamp时间戳(签名)参数sign签名 返回值(JSON格式)命名类型描述codeint代码messagestring消息描述packages+float套餐typestring类型(cncm:中国移动cncu:中国联通cnct:中国电信)namestring话费包互亿无线话费API接口协议指南numberint数值(用于充值请求)stateint状态(1启用,0未启用

7、)priceint单价 6.状态码数值描述0未知错误1提交成功1000无此操作类型(action为空或不存在)1001用户名为空1002用户名错误1003手机号码为空1004手机号码为空1005套餐不能为空1006时间戳不能为空1007不存在的套餐1008签名不能为空1009签名错误1010签名过期互亿无线话费API接口协议指南1011账号被冻结1012余额不足1013访问ip与备案ip不相同1014 订单ID不能为空1015 订单ID已存在2001不支持的手机号码2002手机号码已加入黑名单2003不支持的地区3001扣费失败4001系统内部故障 7.签名

8、说明需要把apikey(登录系统获取)放到要签名的键