1.2.4.5 开放API

1.1. 对外数据API

调用方法：

提供数据API服务的地址为https://hubble.netease.com/api/，每一个调用请求需在请求头部内容中传入AccessKey作为认证信息，AccessKey在哈勃产品页面的应用管理->查看AccessKey中获取。

响应内容分为code、message、data。code为服务状态码，message为服务状态信息，data为数据结果；调用方可根据code的值选择对应的后续行为，状态码及其解释见服务响应列表。

1.2. API实例

1.2.1. 概览【Post /data/summary/query】

请求：

curl 'https://hubble.netease.com/api/data/summary/query' \
     -H 'Content-Type: application/json' \
     -H "AccessKey: 2963d35cb2bf51d1" \
     -X POST \
     -d 
     '{
         "name": "totalUser",    
          "appkey": "Web",
          "fromDate": "2017-10-12",
          "toDate": "2017-10-18",
          "type": "user"
     }'

响应：

{
    "code": 200,
    "message": "成功",
    "data": {
        "avg": "207762",
        "values": [
            "{\"2017-10-12\":{\"value\":\"202999\",\"pre\":\"197468\"}}",
            "{\"2017-10-13\":{\"value\":\"203834\",\"pre\":\"198236\"}}",
            "{\"2017-10-14\":{\"value\":\"204591\",\"pre\":\"198980\"}}",
            "{\"2017-10-15\":{\"value\":\"205376\",\"pre\":\"199826\"}}",
            "{\"2017-10-16\":{\"value\":\"206169\",\"pre\":\"200603\"}}",
            "{\"2017-10-17\":{\"value\":\"206913\",\"pre\":\"201450\"}}",
            "{\"2017-10-18\":{\"value\":\"207762\",\"pre\":\"202236\"}}"
        ],
        "ratio": "2.78%",
        "setAvg": true,
        "valuesSize": 7,
        "valuesIterator": [
            "{\"2017-10-12\":{\"value\":\"202999\",\"pre\":\"197468\"}}",
            "{\"2017-10-13\":{\"value\":\"203834\",\"pre\":\"198236\"}}",
            "{\"2017-10-14\":{\"value\":\"204591\",\"pre\":\"198980\"}}",
            "{\"2017-10-15\":{\"value\":\"205376\",\"pre\":\"199826\"}}",
            "{\"2017-10-16\":{\"value\":\"206169\",\"pre\":\"200603\"}}",
            "{\"2017-10-17\":{\"value\":\"206913\",\"pre\":\"201450\"}}",
            "{\"2017-10-18\":{\"value\":\"207762\",\"pre\":\"202236\"}}"
        ],
        "setValues": true,
        "setRatio": true
    }
}

参数说明

• type: 数值量度
  • "user":用户
  • "deivce":设备
• name: 指标类型。取值内容见概览参数列表;
• appkey: 应用名称。查询移动应用数据时，值为"mobile"

1.2.2. 用户分群列表【GET /data/user_group/list】

请求：

curl 'https://hubble.netease.com/api/data/user_group/list' \
 -H 'AccessKey:    2963d35cb2bf51d1'

响应：

{
    "code": 200,
    "message": "成功",
    "data": [
        {
            "name": "测试1234",
            "count": 539201
        },
        {
            "name": "测试分群",
            "count": 0
        }
    ]
}

参数说明

• name：分群名称
• count：分群当前计算结果

1.2.3. 用户分群明细【GET /data/user_group/details】

请求：

curl 'https://hubble.netease.com/api/data/user_group/details?userGroupName=购买成功用户' \
 -H 'AccessKey:    2963d35cb2bf51d1'

响应：

{
    "code": 200,
    "message": "成功",
    "data": "http://nos.netease.com/hubbledatabucket/css1_1508742578812.csv?Signature=ervvq3zgR8KMxIGl0UYzJOdkiu6IMoH3KaQnrw%2BW8TA%3D&Expires=1508828979&NOSAccessKeyId=6daf9662f1fb4e8298a64908487d3df4"
}

参数说明

• userGroupName：用户分群名称
• data：data中url是用户分群详细结果的CSV下载地址，调用方须再次请求该地址进行数据下载

1.2.4. 概览参数列表

1.2.5. 服务响应列表