Todos os produtos
Search
Central de documentação

Qoder CN Series:Listar execuções de agendamento

Última atualização: Jul 15, 2026

Lista registros de execução do Schedule Run com paginação.

Cabeçalhos da requisição

Cabeçalho

Obrigatório

Descrição

Authorization

Sim

Bearer <PAT>

Parâmetros de consulta

Parâmetro

Tipo

Obrigatório

Padrão

Descrição

identity_id

string

Sim

-

ID da Forward Identity proprietária das execuções.

schedule_id

string

Não

-

Filtra por ID do agendamento.

status

string

Não

-

Filtra pelos status pending, running, completed, failed ou skipped.

trigger_type

string

Não

-

Filtra pelo tipo schedule ou manual.

has_error

boolean

Não

-

Retorna apenas execuções com ou sem erros.

limit

integer

Não

20

Tamanho da página, até 100.

after_id

string

Não

-

Cursor para a próxima página.

before_id

string

Não

-

Cursor para a página anterior.

Exemplo de requisição

curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/schedule_runs' \
  -H "Authorization: Bearer $QODER_PAT"

Exemplo de resposta

HTTP 200 OK

{
  "data": [
    {
      "id": "srun_019f00112233445566778899aabbccdd",
      "schedule_id": "sched_019f00112233445566778899aabbccdd",
      "identity_id": "idn_019eabc123",
      "template_id": "tmpl_support",
      "session_id": "sess_019ec55a68b37e1e8d660691af161ab4",
      "status": "completed",
      "trigger_context": {
        "type": "schedule",
        "scheduled_at": "2026-06-22T01:00:00Z"
      },
      "result_payload": "Today's technology highlights: ...",
      "push_sink": "im_channel",
      "push_status": "succeeded",
      "push_finished_at": "2026-06-22T01:00:21Z",
      "attempt": 1,
      "triggered_at": "2026-06-22T01:00:00Z",
      "started_at": "2026-06-22T01:00:03Z",
      "completed_at": "2026-06-22T01:00:20Z",
      "duration_ms": 17000,
      "created_at": "2026-06-22T01:00:00Z"
    }
  ],
  "first_id": "srun_019f00112233445566778899aabbccdd",
  "last_id": "srun_019f00112233445566778899aabbccdd",
  "has_more": false
}

Campos da resposta

Campo

Tipo

Descrição

data

array

Objetos Schedule Run na página atual.

first_id

string \

null

ID da primeira execução na página atual.

last_id

string \

null

ID da última execução na página atual.

has_more

boolean

Indica se há mais registros disponíveis.

Cada item em data[] é um objeto Schedule Run com os mesmos campos da operação Get schedule run, incluindo trigger_context, error, push_sink, push_status e campos de tempo de execução.

Erros

HTTP

Tipo

Código

Gatilho

400

invalid_request_error

invalid_identity

O parâmetro identity_id está ausente ou é inválido.

400

invalid_request_error

invalid_pagination

Os parâmetros de paginação são inválidos.

401

authentication_error

authentication_required

PAT inválido ou expirado.

Observações

  • O Schedule Run é um recurso independente.

  • Os status completed, failed e skipped são estados terminais.

  • O campo push_status rastreia o status de entrega de streaming via IM e é independente do status principal.