a13nDocs
API 参考执行

读取 Span 内容

读取单个 Span 内容的片段。只向后端查询该 Span；trace 中没有此 Span 时 items 为空。通过 version 和 next_offset 继续读取内容片段。

GET/api/v1/traces/{trace_id}/spans/{span_id}/content

读取单个 Span 内容的片段。只向后端查询该 Span；trace 中没有此 Span 时 items 为空。通过 version 和 next_offset 继续读取内容片段。

认证与授权

认证与授权Bearer <token>

工作空间 API 密钥（a13n_...）

传递位置: header

路径参数

trace_id*Trace Id
匹配规则^[0-9a-f]{32}$
span_id*Span Id
匹配规则^[0-9a-f]{16}$

查询参数

section?Section
默认值"all"

可选值

  • "all"
  • "input"
  • "output"
  • "attributes"
  • "resource_attributes"
  • "events"
  • "links"
  • "usage"
offset?Offset

以 Unicode 码点计量的偏移量；通过 next_offset 继续读取。

范围0 <= value
默认值0
limit?Limit

本片段最多包含的 Unicode 码点数。

范围1 <= value <= 4000
默认值4000
version?|

首次读取返回的内容版本；偏移量大于 0 时必填。

query?|

按原文搜索，区分大小写。

请求头参数

X-Workspace-ID?|

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

响应体

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/traces/string/spans/string/content"
{  "items": [    {      "has_more": true,      "match_offset": 0,      "media_type": "text/plain",      "next_offset": 0,      "offset": 0,      "query": "string",      "representation": "fragment",      "source": "string",      "source_truncated": false,      "text": "string",      "total_chars": 0,      "version": "string"    }  ],  "next_cursor": "string"}