API de Calendário
A API de Calendário oferece uma visão única do seu conteúdo social agendado e publicado. Cada entrada representa um clipe na fila para publicação ou já entregue a uma plataforma conectada. Use esses endpoints para listar entradas do calendário, reagendar ou atualizar um post com PATCH, e cancelar um post pendente com DELETE.
Convenções
As requisições usam a URL base https://api.vdclip.com com o cabeçalho Authorization: Bearer vdck_.... A API é apenas servidor-para-servidor e não tem CORS.
Respostas bem-sucedidas retornam o recurso diretamente. Erros retornam um array errors. O endpoint de listagem usa paginação com um cursor mais limit; siga o cursor retornado.
Reagendar e cancelar aplicam-se apenas a posts pendentes. Depois que um post é entregue, ele não pode ser cancelado, então um PATCH ou DELETE contra uma entrada já publicada é rejeitado. Ler o calendário requer o escopo vdclip:calendar:read; reagendar e cancelar requerem vdclip:calendar:write. Um escopo ausente retorna MISSING_SCOPE, e um id de post desconhecido retorna NOT_FOUND.
Endpoints
Listar conteúdo agendado/publicado
GET /v1/calendar
Reagendar/atualizar um post agendado
PATCH /v1/calendar/{post_id}
Cancelar um post agendado
DELETE /v1/calendar/{post_id}