a13nDocs
API 参考Findings

创建发现

POST/api/v1/findings

认证与授权

认证与授权Bearer <token>

工作空间 API 密钥(a13n_...)

传递位置: header

请求头参数

X-Workspace-ID?|

登录会话作用的工作空间 ID,登录会话必须提供。API 密钥作用于自身工作空间,无需提供;禁止指定其他工作空间。

请求体

application/json

TypeScript 类型定义

在 TypeScript 中使用 request body 类型。

响应体

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/findings" \  -H "Content-Type: application/json" \  -d '{    "agent_id": "string",    "agent_revision_id": "string",    "category": "unclear_request",    "evidence": [      {        "run_id": "string",        "trace_id": "string"      }    ],    "explanation": "string",    "source_key": "string",    "suggestion": "string",    "title": "string"  }'
{  "agent_id": "string",  "agent_revision_id": "string",  "analysis_id": "string",  "assessment": "unreviewed",  "assessment_note": "string",  "category": "unclear_request",  "closed": true,  "created_at": "2019-08-24T14:15:22Z",  "created_by_id": "string",  "evidence": [    {      "run_id": "string",      "span_ids": [        "string"      ],      "trace_id": "string"    }  ],  "explanation": "string",  "id": "string",  "limitations": "",  "severity": "critical",  "source_key": "string",  "source_run_id": "string",  "suggestion": "string",  "title": "string",  "updated_at": "2019-08-24T14:15:22Z",  "version": 0,  "workspace_id": "string"}