流量快充宝流量充值平台接口规范0923

流量订购接口版本号修订人修订日期修订内容V1.0李秉权2015-4-5创建文档接口约定HTTP使用GET,POST方式请求，实体内容全部采用键值对格式进行数据描述，响应实体内容为json格式，并采用UTF-8编码。订购接口单条订购接口接口地址POST 测试环境：http://98:8080/nettraffic/api/order访问所带参数参数是否必要说明customer必要渠道商ID，由平台提供product必要产品编码timestamp必要时间戳（即从1970-01-01到现在的毫秒数）phone必要号码。effectType不必要生效方式默认立即生效0立即生效1次月生肖userKey必要用于安全认证，值得计算方式：由customer+token+timestamp生成的字符串MD5加密生成。Token是平台分配给渠道商的唯一标识returnUrl不必要，推荐调用者主动回调地址参数,当有运营商反馈时会调用此地址做回调,也可以通过查询接口查询订单状态请求实体例子：KEY=VALUE("customer","10000")("product","CZ001")("timestamp","1391759277433")("phone",)("effectType","0")("userKey","0f18abd25e9519cd69b0b4848fa393fd")("returnUrl","http://host:port/path")http://98:8080/nettraffic/api/order?customer=10000&product=CZ001×tamp=1391759277433&phoneeffectType=0&userKey=0f18abd25e9519cd69b0b4848fa393fd&returnUrl=http://host:port/path响应实体例子：{"resultCode":"0","resultMsg":"预约订购成功!","transCode":"123456"} 参数是否必要备注resultCode必要状态标志0：提交成功，不代表充值成功1：订购成功，充值成功其他参照错误码resultMsg必要描述transCode必要订购唯一标识平台返回给渠道商的唯一交易标识订单查询订购主动查询访问地址GET http://98:8080/nettraffic/api/transaction访问所带参数customer必要渠道商ID，由平台提供timestamp必要时间戳（即从1970-01-01到现在的毫秒数）transCode必要平台唯一订购标识。userKey必要用于安全认证，值得计算方式：由customer+token+timestamp生成的字符串MD5加密生成。Token是平台分配给渠道商的唯一标识请求实体例子：KEY=VALUE("customer","10000")("timestamp","1391759277433")("transCode","123456")("userKey","0f18abd25e9519cd69b0b4848fa393fd")http://98:8080/nettraffic/api/transaction?customer=10000×tamp=1391759277433&transCode=123456&userKey=0f18abd25e9519cd69b0b4848fa393fd响应实体例子：{"resultCode":"0","resultMsg":"执行成功!","phone":}参数是否必要备注resultCode必要状态标志1：订购成功2：订单处理中（和提交成功含义一样）其他参照错误码resultMsg必要描述phone必要号码回调接口接口描述：在单条订购接口中，当returnUrl配置后，在充值成功后，会增加回调。回调参数如下：参数是否必要备注resultCode必要状态标志1：订购成功，充值成功其他参照错误码resultMsg必要描述transCode必要订购唯一标识平台返回给渠道商的唯一交易标识请在收到回调后,返回“0”,表明已接受回调产品查询接口接口地址GET http://98:8080/nettraffic/api/product接口描述：获取分配给渠道商的产品和价格请求实体内容参数是否必要说明customer必要渠道商ID，由平台提供timestamp必要时间戳（即从1970-01-01到现在的毫秒数）phone不必要号码，不传代表查询该渠道商所有产品，传手机号代表查询该手机号可以充值的产品userKey必要用于安全认证，值得计算方式：由customer+token+timestamp生成的字符串MD5加密生成。Token是平台分配给渠道商的唯一标识请求实体例子：KEY=VALUE("customer","10000")("timestamp","1391759277433")("phone",)("userKey","0f18abd25e9519cd69b0b4848fa393fd")http://98:8080/nettraffic/api/product?customer=10000×tamp=1391759277433&phoneuserKey=0f18abd25e9519cd69b0b4848fa393fd响应实体例子：{"resultCode":"0","resultMsg":"提交成功!","products":[ {"code":"CZ001","name":"100M流量","spid":"0","costprice":"9""size":"100","description":"100M不清零"}]} 参数是否必要备注resultCode必要状态标志0：提交成功非0：查询失败resultMsg必要描述products[]必要产品列表products—>code必要产品平台唯一编码products—>name必要产品名称products—>spid必要运营商products—>costprice必要零售价products—>size必要流量大小（M）products—>description必要产品描述余额查询接口接口地址GET http://98:8080/nettraffic/api/balance接口描述：获取渠道商账户余额和信用可用额度请求实体内容参数是否必要说明customer必要渠道商ID，由平台提供timestamp必要时间戳（即从1970-01-01到现在的毫秒数）userKey必要用于安全认证，值得计算方式：由customer+token+timestamp生成的字符串MD5加密生成。Token是平台分配给渠道商的唯一标识请求实体例子：KEY=VALUE("customer","10000")("timestamp","1391759277433")("userKey","0f18abd25e9519cd69b0b4848fa393fd")http://98:8080/nettraffic/api/product?customer=10000×tamp=1391759277433&userKey=0f18abd25e9519cd69b0b4848fa393fd响应实体例子：{"resultCode":"0","resultMsg":"提交成功!","balance":0.00,"credit":21:01} 参数是否必要备注resultCode必要状态标志0：提交成功非0：查询失败resultMsg必要描述balance必要账户余额credit必要可用额度环境信息测试环境信息：测试环境地址98:8080CustomerapitestToken1389651247测试产品Product02310001002正式环境地址：09端口：80其他和测试环境一样错误码定义错误码备注0提交成功1订购成功2订单处理中10参数错误11不支持的订购方式12号码不合法13请求渠道商客户名无效14请求渠道商Token错误15请求时间无效16请求产