API de clipes

Os clipes são criados pelo processamento e lidos pelo detalhe do projeto. Os endpoints abaixo cobrem a publicação: agendamento individual, em lote e a listagem de agendamentos.

Agendar clipe

POST /clips/:clipId/schedule

Body:

{
  "provider": "tiktok",
  "title": "Título do post",
  "scheduledAt": "2026-07-20T14:00:00Z"
}

Campo	Tipo	Descrição
provider	string	tiktok, instagram ou youtube — requer integração ativa
title	string	Título/legenda da publicação
scheduledAt	string	Data e hora em ISO 8601 (UTC)

Resposta: 201 Created

{
  "id": "uuid",
  "userId": "uuid",
  "clipId": "uuid",
  "projectId": "uuid",
  "provider": "tiktok",
  "title": "Título do post",
  "scheduledAt": "2026-07-20T14:00:00Z",
  "status": "pending",
  "createdAt": "2026-07-09T10:00:00Z"
}

Listar agendamentos

GET /clips/scheduled

Aceita paginação (page, limit).

Resposta:

{
  "scheduledPosts": [...],
  "total": 15,
  "page": 1,
  "limit": 20
}

Agendar em lote

POST /projects/:id/bulk-schedule

Agenda vários clipes de um projeto com intervalo fixo entre publicações.

Body:

{
  "scheduledAt": "2026-07-20T14:00:00Z",
  "intervalHours": 2,
  "providers": ["tiktok", "instagram"],
  "caption": "Legenda personalizada (opcional)"
}

Campo	Tipo	Descrição
scheduledAt	string	Data/hora da primeira publicação (ISO 8601, UTC)
intervalHours	number	Intervalo entre publicações consecutivas
providers	string[]	Redes de destino
caption	string	Legenda de publicação opcional, aplicada a todos os clipes

Resposta:

{
  "scheduledPosts": [...],
  "count": 8
}

Ciclo de status

Os agendamentos transitam por pending → publishing → published (ou failed) — a referência completa está em API de agendamento.

---

Próximos passos: Agendamento · Integrações