获取产品数据概况

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

本文介绍获取产品数据概况的 API。

接口描述

根据产品 ID 获取该产品的各类数据概况。包括该产品下设备激活相关数据、App 用户相关数据、用户反馈相关数据和设备故障相关数据等。

接口地址

GET: /v1.0/statistics-datas-survey

请求参数

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

返回参数

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

result 说明

参数名类型说明
dev_activeObject设备激活数据概况
App_registerObjectApp 用户数据概况
user_feedbackObject用户反馈概况
dev_faultObject设备故障概况

dev_fault 说明

参数名类型说明
today_dev_faultString当天故障设备数
yesterday_dev_faultString昨天故障设备数
all_dev_faultString总故障设备数
compared_with_yesterday_dev_faultString相对于昨天相同时间点,今天活跃故障设备增加的比例。取值为 2 即今天是昨天的 2 倍

user_feedback 说明

参数名类型说明
today_feedbackString当天反馈数
all_feedbackString全部反馈数
compared_with_yesterday_feedbackString相对于昨天相同时间点,今天反馈增加的比例。取值为 2 即今天是昨天的 2 倍

dev_active 说明

参数名类型说明
today_activeString当天激活设备数
yesterday_activeString昨天激活设备数
all_activateString累计激活设备数
near7_day_activeString近 7 天激活设备数
last7_day_activeString上一个近 7 天激活设备数 (从近7天到近14天期间的数据)
compared_with_yesterday_activeString相对于昨天相同时间点,今天活跃设备增加的比例。取值为 2 即今天是昨天的 2 倍

App_register 说明

参数名类型说明
today_addString当天注册用户数
yesterday_addString昨天注册用户数
all_addString总注册用户数
today_liveString当天活跃用户数
yesterday_liveString昨天活跃用户数
compared_with_yesterday_addString相对于昨天相同时间点,今天注册设备增加的比例。取值为 2 即今天是昨天的 2 倍
compared_with_yesterday_liveString相对于昨天相同时间点,今天活跃设备增加的比例。取值为 2 即今天是昨天的 2 倍

请求示例

GET: /v1.0/statistics-datas-survey?product_id=12345

返回示例

{
    "result": {
        "user_feedback": {
            "all_feedback": "2",
            "today_feedback": "0",
            "compared_with_yesterday_feedback": "0%"
        },
        "dev_fault": {
            "compared_with_yesterday_dev_fault": "0.00%",
            "all_dev_fault": "0",
            "yesterday_dev_fault": "0",
            "today_dev_fault": "0"
        },
        "dev_active": {
            "all_activate": "5237",
            "compared_with_yesterday_active": "0.00%",
            "today_active": "0",
            "yesterday_active": "0"
        },
        "App_register": {
            "all_add": "7915",
            "today_add": "0",
            "compared_with_yesterday_live": "0.00%",
            "yesterday_add": "0",
            "compared_with_yesterday_add": "0.00%"
        }
    },
    "t": 1545286977957,
    "success": true
}

错误码

参考 错误码