终端状态信息推送接口(4.0.8.1及以上版本支持）

POST

/ace/service/chiansec/endpoint/status

终端状态信息推送接口，状态信息包括：终端心跳时间，设备标识，登入账号，风险信息

接口验证采用：Basic Auth 认证 (推送信息接收方提供认证的用户/密码)

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Header 参数

Body 参数application/json

示例

{
      "agentId": "b1b2c518bc8de041dd41",
      "agentIp": "192.168.50.18;192.168.100.23",
      "proxyIp": "192.168.50.18",
      "baselineScore": 30022003,
      "idsScore": 0,
      "devuid": "chiantest@A0075E98",
      "macAddr": "7C-8A-E1-A8-63-9B;B4-B5-B6-E9-E9-C7",
      "updated": "2025-01-21T17:25:59+08:00",
      "userid": "chiantest",
      "isAccess": 0,
      "agentName": "DESKTOP-AVQMANM",
      "osVersion": "Windows 11",
      "pushSource":"heartbeat"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/ace/service/chiansec/endpoint/status' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
      "agentId": "b1b2c518bc8de041dd41",
      "agentIp": "192.168.50.18;192.168.100.23",
      "proxyIp": "192.168.50.18",
      "baselineScore": 30022003,
      "idsScore": 0,
      "devuid": "chiantest@A0075E98",
      "macAddr": "7C-8A-E1-A8-63-9B;B4-B5-B6-E9-E9-C7",
      "updated": "2025-01-21T17:25:59+08:00",
      "userid": "chiantest",
      "isAccess": 0,
      "agentName": "DESKTOP-AVQMANM",
      "osVersion": "Windows 11",
      "pushSource":"heartbeat"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code":10000,
    "msg":"成功"
}

修改于 2025-08-22 09:54:30

终端状态信息拉取(4.0.8.1及以上版本支持)

终端推送升级(4.0.11.0以上版本)