卡片分组实时状态快照

POST

https://api.flashcat.cloud/api/v2/firemap/group/snapshot

最后修改时间：2026-08-17 01:33:37

新增的 OpenAPI 推荐入口；用于 card_group 维度 snapshot 查询

按 group_id 返回分组下层状态，避免 mixed/group/snapshot 同时承载 business 与 group 语义造成歧义

mixed/group/snapshot 保留为旧路径兼容，不再作为 OpenAPI 推荐接口

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200

application/json

成功

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://api.flashcat.cloud/api/v2/firemap/group/snapshot' \
--header 'X-User-Token: YOUR_USER_TOKEN' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhY2Nlc3NfdXVpZCI6IjM2ZTRjZjI3LWI4OWYtNDFlZS04ZDhmLWZiMjdhMmZlZGIzOSIsImF1dGhvcml6ZWQiOnRydWUsImV4cCI6MTc3NTExMTEyMywidXNlcl9pZGVudGl0eSI6IjEtcm9vdCJ9.IwPWDg92AjjvuUTGplaXgpexmOSsONx73M7Y7pOI_vE' \
--header 'Content-Type: application/json' \
--data '{
    "timestamp": 1735689600,
    "group_id": 123,
    "orderby": "name",
    "asc": true,
    "status": "all",
    "search": [
        "keyword"
    ],
    "filter_rule": true,
    "rule_id": 123,
    "rule_released": true,
    "filter_alert": true,
    "alert_rule_id": 123
}'

响应示例

{
    "request_id": "0ace0011649b99a4742c592762c584b0",
    "error": null,
    "data": {
        "num_of_red_cards": 1,
        "num_of_marked_cards": 1,
        "num_of_red_items": 1,
        "timestamp": 1735689600,
        "items": [
            "string"
        ],
        "business_groups": [
            {
                "id": 123,
                "num_of_cards": 1,
                "num_of_matched_cards": 1
            }
        ],
        "timestamp_summary": {
            "card_id_by_timestamp": {
                "key": "value"
            }
        }
    }
}

修改于 2026-08-17 01:33:37

首页卡片状态快照

查询卡片历史曲线