Todos os produtos
Search

Este produto

    Qoder CN Series:Executar um agendamento

    Central de documentação

    Qoder CN Series:Executar um agendamento

    Última atualização: Jul 03, 2026

    Acione manualmente uma execução de agendamento.

    Cabeçalhos da requisição

    Cabeçalho

    Obrigatório

    Descrição

    Authorization

    Sim

    Bearer <PAT>

    Content-Type

    Não

    application/json se houver corpo na requisição.

    Idempotency-Key

    Não

    Chave de idempotência opcional para requisições não seguras.

    Parâmetros de caminho

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    schedule_id

    string

    Sim

    ID do agendamento Forward.

    Exemplo de requisição

    curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/schedules/sched_019f00112233445566778899aabbccdd/run' \
  -H "Authorization: Bearer $QODER_PAT"

    Exemplo de resposta

    HTTP 200 OK

    {
  "id": "srun_019f00112233445566778899aabbccdd",
  "schedule_id": "sched_019f00112233445566778899aabbccdd",
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_support",
  "session_id": null,
  "status": "pending",
  "trigger_context": {
    "type": "manual"
  },
  "error": null,
  "result_payload": null,
  "push_sink": null,
  "push_status": "skipped",
  "attempt": 1,
  "triggered_at": "2026-06-22T12:00:00Z",
  "started_at": null,
  "completed_at": null,
  "duration_ms": null,
  "created_at": "2026-06-22T12:00:00Z"
}

    Campos da resposta

    Retorna o objeto de execução de agendamento criado.

    Erros

    HTTP

    Tipo

    Código

    Gatilho

    401

    authentication_error

    authentication_required

    PAT inválido ou expirado.

    404

    not_found_error

    schedule_not_found

    Agendamento inexistente.

    409

    invalid_request_error

    schedule_archived

    Agendamento arquivado.

    409

    invalid_request_error

    schedule_not_active

    Agendamento pausado.

    Observações

    • Se o agendamento atingir execution.max_concurrent_runs, o Forward ainda cria uma execução com status=skipped e error.type=concurrency_limit_reached.

    • Consulte periodicamente a API Get Schedule Run até que status seja completed, failed ou skipped.