因子数据

获取因子数据

GET /api/v2/devices/{device_id}/factors/{factor_id}/data/

参数

参数	类型	必填	说明
device_id	integer	是	设备ID
factor_id	integer	是	因子ID
page	integer	否	页码，从1开始，默认1
page_size	integer	否	每页数量，默认50
min_timestamp	integer	否	最小时间戳（秒），只返回该时间戳之后的数据，默认使用数据保留期限制

示例

GET /api/v2/devices/1/factors/2/data/?page=1&page_size=50&min_timestamp=1704758400

响应

{
    "success": true,
    "data": {
        "total": 100,           // 总记录数
        "data": [
            {
                "agri_id": "DEVICE001-1-00",  // 因子ID
                "v": 25.6,                    // 数值
                "t": 1641715200              // UTC时间戳（秒）
            },
            // ...更多数据
        ]
    },
    "error": null
}

说明

• 返回指定因子的历史数据，按时间倒序排列
• 接口有缓存，缓存时间为5分钟

提示

t字段为UTC时间戳（秒），可根据需要自行转换为本地时间显示。

通过因子内部ID agri_id 获取数据

GET /api/v2/factors/{factor_agri_id}/data/

参数

参数	类型	必填	说明
factor_agri_id	string	是	因子完整ID，如 "xxxxx-1-00"
page	integer	否	页码，从1开始，默认1
page_size	integer	否	每页数量，默认50
min_timestamp	integer	否	最小时间戳（UTC时间，秒），只返回该时间戳之后的数据，默认使用数据保留期限制

示例

GET /api/v2/factors/xxxxx-1-00/data/?page=1&page_size=50&min_timestamp=1704758400

响应

{
    "success": true,
    "data": {
        "total": 100,           // 总记录数
        "data": [
            {
                "agri_id": "DEVICE001-1-00",  // 因子ID
                "v": 25.6,                    // 数值
                "t": 1641715200              // UTC时间戳（秒）
            },
            // ...更多数据
        ]
    },
    "error": null
}

说明

• 返回指定因子的历史数据，按时间倒序排列
• 接口有缓存，缓存时间为5分钟