Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.clipping.cc/llms.txt

Use this file to discover all available pages before exploring further.

Um schedule roda um dos workflows de um reporter numa cadência sobre um conjunto de coleções. Vídeos novos nessas coleções são sincronizados e processados automaticamente — sem disparo manual.

​
1. Crie o schedule

curl -X POST https://api.clipping.cc/v1/reporters/rep_123/schedules \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{
        "name": "Digest diário de IA",
        "workflow_id": "wf_123",
        "interval_hours": 24,
        "collection_ids": ["col_123"],
        "enabled": true,
        "max_videos_per_channel": 5,
        "max_age_hours": 48
      }'
CampoSignificado
workflow_idQual workflow rodar (obrigatório).
interval_hoursDe quanto em quanto tempo o schedule fica “due”.
collection_idsColeções cujos canais são sincronizados + processados.
max_videos_per_channelTeto por canal por rodada.
max_age_hoursIgnora vídeos mais velhos que isso.
enabledLiga/desliga sem deletar.

​
2. Rode agora (opcional)

Não quer esperar a cadência? Dispare na hora — é assíncrono: 
curl -X POST https://api.clipping.cc/v1/reporters/rep_123/schedules/sch_123/run \
  -H "Authorization: Bearer ck_live_…"

{ "status": "dispatched", "schedule_id": "sch_123" }
Só uma rodada por schedule executa por vez — disparar uma segunda enquanto uma roda é no-op (não processa em dobro).

​
3. Reveja as rodadas

# rodadas recentes do reporter
curl "https://api.clipping.cc/v1/reporters/rep_123/schedule/runs?limit=20" \
  -H "Authorization: Bearer ck_live_…"

# uma rodada, com eventos por item enriquecidos
curl "https://api.clipping.cc/v1/reporters/rep_123/schedule/runs/42" \
  -H "Authorization: Bearer ck_live_…"
Cada rodada agendada também cria executions que você lista com GET /v1/reporters/{id}/executions.

​
Gerenciar coleções de um schedule

Anexe ou desanexe coleções sem recriar o schedule: 
curl -X POST https://api.clipping.cc/v1/reporters/rep_123/schedules/sch_123/collections \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "collection_id": "col_456" }'