Todos os produtos
Search

Este produto

    Qoder CN Series:Listar eventos de sessão

    Central de documentação

    Qoder CN Series:Listar eventos de sessão

    Última atualização: Jul 15, 2026

    Consulte o histórico de eventos de uma sessão Forward.

    Cabeçalhos da requisição

    Cabeçalho

    Obrigatório

    Descrição

    Authorization

    Sim

    Bearer <PAT>

    Parâmetros de caminho

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    session_id

    string

    Sim

    ID da sessão.

    Parâmetros de consulta

    Parâmetro

    Tipo

    Obrigatório

    Padrão

    Descrição

    limit

    integer

    Não

    20

    Itens por página. Máximo de 100.

    after_id

    string

    Não

    -

    Cursor para eventos posteriores ao Event ID especificado.

    before_id

    string

    Não

    -

    Cursor para eventos anteriores ao Event ID especificado.

    order

    string

    Não

    asc

    Ordem de classificação: asc ou desc.

    type

    string

    Não

    -

    Filtra por tipo de evento. Aceita valores separados por vírgula.

    types[]

    string

    Não

    -

    Filtro de tipo de evento em formato de array.

    include_tool_calls

    boolean

    Não

    true

    Inclui eventos de chamada de ferramenta.

    include_thinking

    boolean

    Não

    true

    Inclui eventos de raciocínio.

    Exemplo de requisição

    curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx/events?limit=20&order=asc' \
  -H "Authorization: Bearer $QODER_PAT"

    Exemplo de resposta

    HTTP 200 OK

    {
  "data": [
    {
      "id": "evt_xxx",
      "type": "agent.message",
      "session_id": "sess_xxx",
      "content": [
        {
          "type": "text",
          "text": "Here is the analysis result."
        }
      ],
      "processed_at": "2026-06-22T11:00:03Z"
    }
  ],
  "first_id": "evt_xxx",
  "last_id": "evt_xxx",
  "has_more": false
}

    Campos da resposta

    Campo

    Tipo

    Descrição

    data

    array

    Objetos de evento na página atual.

    first_id

    string

    null

    ID do primeiro evento nesta página.

    last_id

    string

    null

    ID do último evento nesta página.

    has_more

    boolean

    Indica se há mais registros.

    Campos do evento

    Campo

    Tipo

    Descrição

    id

    string

    ID do evento.

    type

    string

    Tipo do evento.

    session_id

    string

    ID da sessão.

    processed_at

    string

    Timestamp de processamento, quando disponível.

    content

    array

    Retornado para eventos semelhantes a mensagens.

    Erros

    HTTP

    Tipo

    Código

    Causa

    400

    invalid_request_error

    invalid_event_cursor

    O cursor não pertence a esta sessão.

    400

    invalid_request_error

    invalid_pagination

    Parâmetros de paginação inválidos.

    401

    authentication_error

    TOKEN_INVALID

    PAT inválido ou expirado.

    404

    not_found_error

    session_not_found

    A sessão não existe.

    Observações

    • Tipos de evento desconhecidos não causam falha na requisição. Quando disponíveis, são retornados com o envelope mínimo.

    • O Forward filtra campos privados de runtime, como IDs de agente, IDs de ambiente, recursos, vaults, IDs de worker, traces e payloads brutos, de depuração ou internos.