API Social
A API Social expõe as contas sociais que um usuário conectou ao VDClip. Ela é somente leitura: liste as contas conectadas para descobrir quais plataformas estão disponíveis antes de publicar ou agendar um clipe. Cada entrada informa a plataforma, o identificador da conta e seu status de conexão. Use esses identificadores como destinos de publicação quando você chamar o endpoint de publicação em um clipe. Conectar e desconectar contas acontece no painel do VDClip, não pela API.
Todas as requisições /v1 usam o cabeçalho Authorization: Bearer vdck_…. A API é apenas servidor a servidor e não tem CORS. Este endpoint exige o escopo vdclip:social:read; publicar usa um escopo separado e limitado por plano, vdclip:social:publish. Consulte a página de preços para detalhes dos planos.
Convenções
Respostas bem-sucedidas retornam o recurso diretamente, sem envelope. O endpoint de listagem usa paginação com o parâmetro de consulta cursor (máx. 100) e retorna { "items": [...], "next_cursor": "<opaque>" | null }. Os erros retornam { "errors": [{ "code", "description", <location>? }] }; códigos comuns aqui são invalid_api_key (401), missing_scope (403) e rate_limited (HTTP 429 com um cabeçalho Retry-After).
Endpoints
Listar contas sociais conectadas
GET /v1/social-accounts