---
title: "Agent 生态 API · identity"
method: POST
path: "/api/v1/agent-card/identity"
tags: ["ecosystem"]
---

# Agent 生态 API · identity

`POST /api/v1/agent-card/identity`

## Request

- Base URL: `https://aishield.tools`
- URL: `https://aishield.tools/api/v1/agent-card/identity`
- Auth: HTTP bearer

本端点由运行时探针自动登记（清单：api/openapi_runtime_paths.json），schema 由真实响应反推，非手工编写。

## Request body

- object
  - `card` object: agent card
  - `trust_score` number: 信任评分（可选）

## Response `200`

- object
  - `agent_id` string
  - `kya` object
    - `kid` string
    - `alg` string
    - `iat` string
    - `schema` string
    - `claims` object[]
    - `constraints` object[]
    - `namespace` string
  - `kya_sd_jwt_compact` string
  - `web_bot_auth` object
    - `headers` object
      - `Date` object
      - `(request-target)` object
      - `Content-Digest` object
      - `X-Web-Bot-Auth-Agent` object
      - `X-Web-Bot-Auth-URL` object
      - `X-Web-Bot-Auth-Timestamp` object
    - `schema` string
  - `erc8004` unknown

---

[API](https://skmtc.dev/aishield/apis/aishield-api.md) · [All operations](https://skmtc.dev/aishield/apis/aishield-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aishield/apis/aishield-api/revisions/9a04f4fb94bd?raw)