列出会话事件

通过 OMA API 列出会话事件。

GET /v1/sessions/{session_id}/events

列出会话事件

cURL

curl --request GET \
  --url http://localhost:38080/v1/sessions/{session_id}/events \
  --header 'X-Api-Key: <api-key>'

200

{
  "data": [
    {
      "type": "user.message",
      "id": "sevt_011CZkZGOp0iBcp4kaQSihUmy",
      "content": [
        {
          "type": "text",
          "text": "我的订单 #1234 到哪里了？"
        }
      ],
      "processed_at": "2026-03-15T10:00:00Z"
    },
    {
      "type": "agent.message",
      "id": "sevt_011CZkZHPq1jCdq5lbRTjiVnz",
      "content": [
        {
          "type": "text",
          "text": "Let me look up order #1234 for you."
        }
      ],
      "processed_at": "2026-03-15T10:00:00Z"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

每个请求都必须发送 ?beta=true。

授权

omaApiKeyomaBearer

X-Api-Key · string · header · 默认值: sk-ant-local-default · 必填

OMA 工作区 API 密钥。

请求头

anthropic-version · string

anthropic-beta · string

路径参数

session_id · string · 必填

会话标识符。

查询参数

beta · enum<boolean> · 必填

为此接口启用 Beta API 合同，必须为 true。

可用选项: true

limit · integer<int32>

单页返回数量上限。

page · string

来自上一个响应 next_page 的不透明分页游标。

order · enum<string>

结果的排序方向，按事件的 processed_at 排序。默认为 asc（按时间先后）。 ListOrder 枚举

可用选项: asc, desc

types[] · string[]

按事件类型过滤。取值与返回事件中的 type 字段一致（例如 user.message 或 agent.tool_use）。省略时返回所有事件类型。

created_at[gte] · string<date-time>

返回在此时间或之后创建的事件（含该时间）。与事件的 processed_at 值比较。 RFC 3339 格式的时间戳

created_at[gt] · string<date-time>

返回在此时间之后创建的事件（不含该时间）。与事件的 processed_at 值比较。 RFC 3339 格式的时间戳

created_at[lte] · string<date-time>

返回在此时间或之前创建的事件（含该时间）。与事件的 processed_at 值比较。 RFC 3339 格式的时间戳

created_at[lt] · string<date-time>

返回在此时间之前创建的事件（不含该时间）。与事件的 processed_at 值比较。 RFC 3339 格式的时间戳

响应

200

application/json

请求成功。

session 的分页事件列表。

data · object[]

该会话的事件，按 processed_at 排序。

会话对话中的用户消息事件。

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Option 17

Option 18

Option 19

Option 20

Option 21

Option 22

Option 23

Option 24

Option 25

Option 26

Option 27

Option 28

Option 29

Option 30

Option 31

Option 32

Option 33

Option 34

Option 35

Show child attributes

示例:

{
  "type": "user.message",
  "id": "sevt_011CZkZGOp0iBcp4kaQSihUmy",
  "content": [
    {
      "type": "text",
      "text": "我的订单 #1234 到哪里了？"
    }
  ],
  "processed_at": "2026-03-15T10:00:00Z"
}

示例:

[
  {
    "type": "user.message",
    "id": "sevt_011CZkZGOp0iBcp4kaQSihUmy",
    "content": [
      {
        "type": "text",
        "text": "我的订单 #1234 到哪里了？"
      }
    ],
    "processed_at": "2026-03-15T10:00:00Z"
  },
  {
    "type": "agent.message",
    "id": "sevt_011CZkZHPq1jCdq5lbRTjiVnz",
    "content": [
      {
        "type": "text",
        "text": "Let me look up order #1234 for you."
      }
    ],
    "processed_at": "2026-03-15T10:00:00Z"
  }
]

next_page · string | null

下一页的不透明游标。没有更多结果时为 null。

示例:

"page_MjAyNS0wNS0xNFQwMDowMDowMFo="