Flashcat API

获取机器列表-专业版

GET

https://api.flashcat.cloud/api/n9e-plus/targets

最后修改时间：2025-05-15 05:36:08

注：第三方系统使用中

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.flashcat.cloud/api/n9e-plus/targets?query=&gids=1&limit=30&p=1&hosts=ident1,127.0.0.1' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhY2Nlc3NfdXVpZCI6Ijc1YjY4NDg2LTI4OWQtNDc2MS1hMDI0LWVjODdiZGVkNTZkZCIsImF1dGhvcml6ZWQiOnRydWUsImV4cCI6MTcyMzgwMTY3NywidXNlcl9pZGVudGl0eSI6IjEtcm9vdCJ9.DcKTTZFOUMU1ulO6SdpdD9x2xx1rb2qL5OFEdGY9OZs' \
--header 'X-Language: zh_CN'

响应示例

{
    "dat": {
        "list": [
            {
                "id": 1,
                "group_id": 0,
                "group_objs": [
                    {
                        "id": 1,
                        "name": "Default Busi Group",
                        "label_enable": 0,
                        "label_value": "",
                        "create_at": 1733230339,
                        "create_by": "root",
                        "update_at": 1742987768,
                        "update_by": "root",
                        "user_groups": null
                    },
                    {
                        "id": 3,
                        "name": "mon-n9e",
                        "label_enable": 0,
                        "label_value": "",
                        "create_at": 1735189840,
                        "create_by": "root",
                        "update_at": 1735189840,
                        "update_by": "root",
                        "user_groups": null
                    },
                    {
                        "id": 4,
                        "name": "service-n9e",
                        "label_enable": 0,
                        "label_value": "",
                        "create_at": 1735189856,
                        "create_by": "root",
                        "update_at": 1735189856,
                        "update_by": "root",
                        "user_groups": null
                    }
                ],
                "group_ids": [
                    1,
                    3,
                    4
                ],
                "ident": "dev-backup-01",
                "note": "",
                "tags": [
                    "service=mon"
                ],
                "update_at": 1745460278,
                "host_ip": "10.99.1.109",
                "agent_version": "v0.3.58",
                "os": "linux",
                "host_tags": null,
                "meta_info": {
                    "Agent版本": "v0.3.58",
                    "CPU使用率": "47.12%",
                    "CPU架构": "amd64",
                    "CPU核数": 2,
                    "config": null,
                    "engine_name": "default",
                    "extend_info": {},
                    "global_labels": null,
                    "host_ip": "10.99.1.109",
                    "主机名": "dev-backup-01",
                    "偏移时间": "19(ms)",
                    "内存使用率": "33.48%",
                    "心跳时间": "1745460278524(2025-04-24 10:04:38)",
                    "操作系统": "linux",
                    "来源IP": "10.99.1.109"
                },
                "apps": null,
                "new_version": "",
                "download_url": "",
                "unixtime": 1745460278524,
                "offset": 19,
                "target_up": 2,
                "mem_util": 33.479210213453726,
                "cpu_num": 2,
                "cpu_util": 47.12328767285528,
                "arch": "amd64",
                "remote_addr": "10.99.1.109"
            },
            {
                "id": 14,
                "group_id": 0,
                "group_objs": [
                    {
                        "id": 3,
                        "name": "mon-n9e",
                        "label_enable": 0,
                        "label_value": "",
                        "create_at": 1735189840,
                        "create_by": "root",
                        "update_at": 1735189840,
                        "update_by": "root",
                        "user_groups": null
                    }
                ],
                "group_ids": [
                    3
                ],
                "ident": "dev-backup-02",
                "note": "",
                "tags": [],
                "update_at": 1744773121,
                "host_ip": "10.131.0.10",
                "agent_version": "v0.4.2",
                "os": "darwin",
                "host_tags": [],
                "meta_info": {
                    "Agent版本": "v0.4.2",
                    "CPU使用率": "47.93%",
                    "CPU架构": "arm64",
                    "CPU核数": 8,
                    "config": null,
                    "engine_name": "default",
                    "extend_info": {},
                    "global_labels": {},
                    "host_ip": "10.131.0.10",
                    "主机名": "dev-backup-02",
                    "偏移时间": "183(ms)",
                    "内存使用率": "84.77%",
                    "心跳时间": "1744773121184(2025-04-16 11:12:01)",
                    "操作系统": "darwin",
                    "来源IP": "10.99.1.103"
                },
                "apps": null,
                "new_version": "",
                "download_url": "",
                "unixtime": 1744773121184,
                "offset": 183,
                "target_up": 0,
                "mem_util": 84.7707748413086,
                "cpu_num": 8,
                "cpu_util": 47.931769717347514,
                "arch": "arm64",
                "remote_addr": "10.99.1.103"
            }
        ],
        "total": 2
    },
    "err": ""
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

query

string

可选

gids

string

可选

不带gids参数返回全部机器，值为0是未归组机器

示例值:

limit

string

可选

示例值:

string

可选

示例值:

hosts

string

可选

机器 ident 或 ip，用","，" "或"\n"分隔

示例值:

ident1,127.0.0.1

Header 参数

Authorization

string

必需

示例值:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhY2Nlc3NfdXVpZCI6Ijc1YjY4NDg2LTI4OWQtNDc2MS1hMDI0LWVjODdiZGVkNTZkZCIsImF1dGhvcml6ZWQiOnRydWUsImV4cCI6MTcyMzgwMTY3NywidXNlcl9pZGVudGl0eSI6IjEtcm9vdCJ9.DcKTTZFOUMU1ulO6SdpdD9x2xx1rb2qL5OFEdGY9OZs

X-Language

string

必需

示例值:

zh_CN