`get_sag_entity`

按实体 ID 获取详情及其关联事件摘要。

英文描述

Get sag entity with related events.

文档更新：2026-08-11T08:16:36+08:00

请求参数

参数名	参数说明	数据类型	样例数据
`entity_id`	实体 UUID，必填	string	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
`event_limit`	关联事件条数，默认 20	integer	20

响应参数

参数名	参数说明	数据类型	样例数据
`code`	业务状态码，0 表示成功	integer	0
`message`	状态说明	string	ok
`data`	分块嵌套对象	object	{}
`meta.source`	数据来源标识	string	sag_entities
`data.entity`	entity 子块数组或对象	array	[]
`data.events`	events 子块数组或对象	array	[]

响应状态说明

状态	说明
`success`	调用成功，返回 code=0 与业务 data
`failed`	参数非法、主键不存在或后端查询异常
`denied`	API Key 无效、已吊销、权限不足（Bearer / X-API-Key；如 L3 Tool 用 L2 Key）

请求示例

{
  "entity_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "event_limit": 20
}

响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "entity": {
      "name": "聚乙烯"
    },
    "events": []
  },
  "meta": {
    "biz_dt": "2026-07-05",
    "source": "sag_entities"
  }
}