一、事件分析查询API

此API用于客户根据书签编号获取到相应事件分析的结果查询

二、调用方法

API URL: https://higateway.haishuu.com/gateway/hi-api/v2/event-analysis-list
请求方式:POST Content-Type: application/json
接口状态:正常

2.1 请求参数

名称 位置 类型 是否必填 描述
hi-api-key header String 访问接口的权限key【获取hi-api-key
字段 名称 类型 是否必填 描述
projectCode 项目编码 String 该数据所属的项目编码【项目编码获取
bookmarkId 书签编号 Long 书签ID【书签编号获取
page 页码 Integer 页码 > 0
pageSize 每页数 Integer 每页数 1000 >= pageSize > 0
curl --request POST \
  --url https://higateway.haishuu.com/gateway/hi-api/v2/event-analysis-list \
  --header 'Content-Type: application/json' \
  --header 'hi-api-key: #K-xxx' \
  --data '{
    "projectCode": "projectCode",
    "bookmarkId": 184xxxx7010,
    "page":1,
    "pageSize":1000
}'

2.2 返回参数

字段 名称 类型 描述
status 接口响应状态码 Integer 成功=200
code 业务响应编码 String 成功=0
message 业务响应描述 String 操作成功
success 接口成功标记 Boolean true 成功, false 失败
data 返回数据 Oject 返回数据
字段 名称 类型 描述
total 数据总条数 Integer 数据总条数
page 页码 Integer 请求页码返回
result 分析数据 List 分析数据
字段 名称 类型 描述
analysis_name 分析指标名称 String 分析指标名称
pk_day 时间 String 时间
calres 计算结果 Long 计算结果
动态分组字段 分组字段 String 多个分组就返回多个字段,如 event.event,event.distinct_id
{
    "code": "0",
    "data": {
        "page": 1,
        "result": [
            {
                "analysis_name": "Web 浏览页面.总次数",
                "calres": 962,
                "event.event_time": "2024-10-28",
                "event.timezone_offset": "-480",
                "pk_day": "2024-10-28"
            }
        ],
        "total": 1
    },
    "message": "操作成功",
    "status": 200,
    "success": true
}

三、错误码

接口响应状态码 接口响应状态码描述 业务响应编码 业务响应编码描述
200 成功 0 成功
5001 业务异常 API_SERVICE_FAIL 查询参数缺失
5001 业务异常 API_PROCESS_FAIL 查询引擎发生错误
5001 业务异常 API_KEY_EXPIRED API_KEY已过期
5001 业务异常 NOT_IN_IP_WHITE_LIST IP白名单限制
5001 业务异常 API_KEY_NOT_EXISTED API_KEY不存在
6001 参数验证异常 PARAM_VERIFY_FAIL 参数验证失败
{
    "status": 5001,
    "code": "NOT_IN_IP_WHITE_LIST",
    "message": "IP白名单限制 [172.23.7.64]",
    "success": false,
    "data": null
}

四、限制

类型 调用限制 描述
普通用户 QPS:2次/秒 接口限制
作者:梁松竹  创建时间:2025-01-16 10:02
最后编辑:梁松竹  更新时间:2025-02-20 16:37