获取活跃设备数据概况

更新时间:2023-06-15 05:10:14

本文介绍获取活跃设备数据概况的 API。

接口描述

根据产品 ID 获取产品下活跃设备的数据。

接口地址

GET: /v1.0/devices/live-datas-survey

请求参数

参数名类型参数位置是否必填说明
product_idStringqueryfalse产品 ID,不填写则获取用户所有产品

返回参数

参数名类型说明
resultObject返回结果

result 说明

参数名类型说明
today_liveString当天活跃设备数
yesterday_liveString昨天活跃设备数
near7_day_liveString近 7 天活跃设备数
last7_day_liveString上一个近 7 天活跃设备数(从近7天到近14天期间的数据)
compared_with_yesterday_liveString相对于昨天相同时间点,今天活跃设备增加的比例。取值为 2 即今天是昨天的 2 倍
rate_of_today_liveString当天活跃数/累计激活数

请求示例

GET: /v1.0/devices/live-datas-survey?product_id=123

返回示例

{
    "result": {
        "last7_day_live": "129",
        "today_live": "99",
        "yesterday_live": "102",
        "near7_day_live": "108",
        "rate_of_today_live": "1.89%"
    },
    "t": 1545278810104,
    "success": true
}

错误码

参考 错误码