申请数据

>流量接口简介 / 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