- 产品介绍
- API文档
>流量接口简介 / Synopsis
为上万家企业和商家提供活动、自媒体推广提供一站式的流量营销服务,通过以下载、注册、签到、积分兑换等方式奖励手机流量,提供活动关注度,从而实现商家和企业拓展新用户和提升客户端活跃度、自媒体增加粉丝和提升转化率、APP提高应用下载量和激活转化率的目的。
>流量接口优势 / Advantage
直接对接中国移动、中国联通、中国电信三大运营商,平均2-5分钟到帐,如遇高峰期,会有适当延时。
>流量接口活动场景 / Scenarios
>流量接口案例 / Example
>流量接口种类 / Type
10M | 30M | 70M | 150M | 500M | |
1G | 3G | 4G | 6G | 11G | |
10M | 20M | 30M | 50M | 100M | |
200M | 300M | 500M | 1G | ||
5M | 10M | 30M | 50M | 100M | |
200M | 500M | 1G |
PS:以上运营商流量均为通用流量
- 流量接口简介
- 流量接口优势
- 流量接口活动场景
- 流量接口案例
- 流量接口种类
- 全部流量套餐列表
- 检测号码支持的流量套餐
- 提交流量充值
- 根据日期时间查询订单
- 状态回调配置
- 订单状态查询
- 错误参照码
- 示例代码
- 其他相关
接口地址:http://v.juhe.cn/flow/list
支持格式:json
请求方式:http get/post
请求示例:http://v.juhe.cn/flow/list?key=您申请的KEY
接口备注:
获取支持的流量套餐列表,如果缓存需要定期更新
请求参数说明:
名称 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
key | string | 是 | 应用APPKEY(应用详细页查询) |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 | |
city | string | 支持城市 | |
company | string | 运营商 | |
companytype | string | 运营商ID | |
type | string | 支持类型1:全国 2:城市 | |
flows | list | 流量套餐列表 | |
id | string | 套餐ID | |
p | string | 套餐流量名称 | |
v | string | 套餐流量值 | |
inprice | string | 价格 | |
JSON返回示例:
{ "reason": "success", "result": [ { "city": "全国", "company": "中国联通", "companytype": "1", "name": "中国联通全国流量套餐", "type": "1", "flows": [ { "id": "1", "p": "50M", "v": "50", "inprice": "5.70" }, { "id": "2", "p": "200M", "v": "200", "inprice": "14.25" }, { "id": "34", "p": "20M", "v": "20", "inprice": "2.85" }, { "id": "35", "p": "100M", "v": "100", "inprice": "9.50" }, { "id": "36", "p": "500M", "v": "500", "inprice": "28.50" } ] }, { "city": "全国", "company": "中国移动", "companytype": "2", "name": "中国移动全国流量套餐", "type": "1", "flows": [ { "id": "3", "p": "10M", "v": "10", "inprice": "2.25" }, { "id": "4", "p": "30M", "v": "30", "inprice": "3.75" }, { "id": "5", "p": "70M", "v": "70", "inprice": "7.50" }, { "id": "7", "p": "500M", "v": "500", "inprice": "22.50" }, { "id": "26", "p": "1G", "v": "1024", "inprice": "37.50" }, { "id": "27", "p": "2048M", "v": "2048", "inprice": "52.50" } ] }, { "city": "全国", "company": "中国电信", "companytype": "3", "name": "中国电信全国流量套餐", "type": "1", "flows": [ { "id": "8", "p": "10M", "v": "10", "inprice": "1.80" }, { "id": "9", "p": "30M", "v": "30", "inprice": "4.50" }, { "id": "10", "p": "100M", "v": "100", "inprice": "9.00" }, { "id": "11", "p": "200M", "v": "200", "inprice": "13.50" }, { "id": "12", "p": "500M", "v": "500", "inprice": "27.00" }, { "id": "28", "p": "1G", "v": "1024", "inprice": "45.00" }, { "id": "32", "p": "50M", "v": "50", "inprice": "6.30" } ] } ], "error_code": 0 }
接口地址:http://v.juhe.cn/flow/telcheck
支持格式:json
请求方式:http get/post
请求示例:http://v.juhe.cn/flow/telcheck?key=申请的KEY&phone=18913513535
接口备注:
根据手机号码获取支持的流量套餐
请求参数说明:
名称 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
phone | string | 是 | 要查询的手机号码 | |
key | string | 是 | 应用APPKEY(应用详细页查询) |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 | |
city | string | 支持城市 | |
company | string | 运营商 | |
companytype | string | 运营商ID | |
type | string | 支持类型1:全国 2:城市 | |
flows | list | 流量套餐列表 | |
id | string | 套餐ID | |
p | string | 套餐流量名称 | |
v | string | 套餐流量值 | |
inprice | string | 价格 |
JSON返回示例:
{ "reason": "success", "result": [ { "city": "全国", "company": "中国移动", "companytype": "2", "name": "中国移动全国流量套餐", "type": "1", "flows": [ { "id": "3", "p": "10M", "v": "10", "inprice": "2.90" }, { "id": "4", "p": "30M", "v": "30", "inprice": "4.84" }, { "id": "5", "p": "70M", "v": "70", "inprice": "9.50" }, { "id": "6", "p": "150M", "v": "150", "inprice": "19.00" }, { "id": "7", "p": "500M", "v": "500", "inprice": "29.04" }, { "id": "26", "p": "1G", "v": "1024", "inprice": "48.40" }, { "id": "27", "p": "2048M", "v": "2048", "inprice": "66.50" }, { "id": "33", "p": "700M", "v": "700", "inprice": "38.72" } ] } ], "error_code": 0 }
接口地址:http://v.juhe.cn/flow/recharge
支持格式:json
请求方式:http get/post
请求示例:http://v.juhe.cn/flow/recharge?key=您申请的KEY&phone=18913513535&pid=8&orderid=a1122111d&sign=721a3f667b0eb63f54517971181e7392
接口备注:
正式使用后建议个人中心绑定IP白名单。
***如果充值过程中,遇到http网络状态异常或返回系统异常,请务必通过订单查询接口检测订单或联系客服,不要直接做失败处理,避免造成不必要的损失!!!
请求参数说明:
名称 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
phone | string | 是 | 需要充值流量的手机号码 | |
pid | string | 是 | 流量套餐ID | |
orderid | string | 是 | 自定义订单号,8-32字母数字组合 | |
key | string | 是 | 应用APPKEY(应用详细页查询) | |
sign | string | 是 | 校验值,md5(OpenID+key+phone+pid+orderid),结果转为小写 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 | |
ordercash | string | 订单金额 | |
cardname | string | 套餐名称 | |
sporder_id | string | 聚合订单号 | |
orderid | string | 用户自定义订单号 | |
phone | string | 充值手机号码 |
JSON返回示例:
{ "reason": "提交充值成功", "result": { "ordercash": "2.10", "cardname": "中国电信省内流量套餐10M", "sporder_id": "143212457209780362", "orderid": "a1122111ds1", "phone": "18913513535" }, "error_code": 0 }
接口地址:http://v.juhe.cn/flow/ordersbydate
支持格式:json
请求方式:http get/post
请求示例:http://v.juhe.cn/flow/ordersbydate?key=&page=1&pagesize=10&starttime=2016-03-01%2000:00:00&endtime=2016-03-16%2000:00:00
接口备注:
根据指定的开始和结束时间查询订单列表,本接口暂只支持查询近60天订单,暂不支持跨月日期查询
请求参数说明:
名称 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
page | int | 否 | 当前页数,默认1 | |
pagesize | int | 否 | 每页显示条数,默认50,最大100 | |
starttime | time | 是 | 格式:2016-03-01 00:00:00,开始和结束时间不能跨月 | |
endtime | time | 是 | 格式:2016-03-10 23:59:59 | |
key | string | 是 | 应用APPKEY(应用详细页查询) |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
JSON返回示例:
{ "reason": "success", "result": { "data": [ { "sporder_id": "1456825779183123445", "uorderid": "20160301174936", "uordercash": "2.000", "cardname": "中国电信全国流量套餐10M", "game_state": "1",/*0:充值中 1:充值成功 9:充值失败 -1:订单无效*/ "game_userid": "1802028****", "addtime": "2016-03-01 17:47:50" } ], "totalcount": 10, "totalpage": 10, "page": 1, "pagesize": 1 }, "error_code": 0 }
接口地址:充值接口测试完毕,联系在线客服进行回调配置,格式参考:http://code.juhe.cn/docs/detail/id/1565
支持格式:
请求方式:
请求示例:
请求参数说明:
名称 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
接口地址:http://v.juhe.cn/flow/ordersta
支持格式:json
请求方式:http get/post
请求示例:
接口备注:
查询订单的最新状态,请确认订单成功提交后,再查询哦~
请求参数说明:
名称 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
orderid | string | 是 | 商家订单号,8-32位字母数字组合,请填写已经成功提交的订单号 | |
key | string | 是 | 应用APPKEY(应用详细页查询) |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{ "reason": "查询成功", "result": { "uordercash": "1.860", "sporder_id": "146944199833560022", "game_state": "9"/*0:充值中 1:成功 9:失败*/ }, "error_code": 0 }
服务级错误码参照(error_code):
错误码 | 说明 | |
---|---|---|
210501 | 错误的手机号码 | |
210502 | 错误的面值 | |
210503 | 检索不到符合该手机号码的流量套餐 | |
210504 | 套餐ID不符合当前手机号 | |
210505 | 余额不足 | |
210506 | 校验值sign错误 | |
210507 | 此号码正在充值中 | |
210508 | 重复的订单号 | |
210509 | 订单生成失败 | |
210510 | 受理充值失败 | |
210511 | 订单号错误/不存在 |
系统级错误码参照:
错误码 | 说明 | 旧版本(resultcode) | |
---|---|---|---|
10001 | 错误的请求KEY | 101 | |
10002 | 该KEY无请求权限 | 102 | |
10003 | KEY过期 | 103 | |
10004 | 错误的OPENID | 104 | |
10005 | 应用未审核超时,请提交认证 | 105 | |
10007 | 未知的请求源 | 107 | |
10008 | 被禁止的IP | 108 | |
10009 | 被禁止的KEY | 109 | |
10011 | 当前IP请求超过限制 | 111 | |
10012 | 请求超过次数限制 | 112 | |
10013 | 测试KEY超过请求限制 | 113 | |
10014 | 系统内部异常 (调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) | 114 | |
10020 | 接口维护 | 120 | |
10021 | 接口停用 | 121 |
错误码格式说明(示例:200201):
2 | 002 | 01 | |
---|---|---|---|
服务级错误(1为系统级错误) | 服务模块代码(即数据ID) | 具体错误代码 |
完整教学代码示例:
语言 | 标题 | 提供者 | 时间 | |
PHP | 流量直充示例 | JoneDwyane | 2015-09-14 17:46:29 | |
Python | 流量直充接口调用示例 | JoneDwyane | 2015-09-14 19:35:25 | |
C# | 流量直充接口调用示例 | JoneDwyane | 2015-09-15 13:34:28 | |
Go | 流量直充接口调用示例 | JoneDwyane | 2015-09-15 19:17:56 | |
JAVA | 流量直充接口调用示例 | silk | 2016-02-26 11:35:47 |
常见问题:
内容 | 详细 | |
---|---|---|
常见问题: | http://www.juhe.cn/qa/index/1495174090 |
其他相关内容
内容 | 详细 | |
技术支持: | info@juhe.cn | |
联系电话: | 0512-62391880 | |
在线客服QQ: | 800076065 |