API

A API é a mesma que as telas usam — não existe rota privilegiada de tela. Toda rota abaixo de /api exige sessão e só enxerga o dado da sua conta.

Agendar

PUT  /api/midia            → { id, tipo, url }
POST /api/publicacoes      → { id, agendado_para, contas, automacao, avisos }
GET  /api/publicacoes
PATCH  /api/publicacoes/:id   (só enquanto nada saiu)
DELETE /api/publicacoes/:id   (cancela o que não saiu)

O corpo de POST /api/publicacoes:

{
  "legenda": "comenta QUERO que eu mando o link",
  "midia": ["<id do PUT>"],
  "contas": ["<id da conta>"],
  "quando": "2026-08-13T18:00",
  "config": { "tiktok": { "legenda": "outra legenda aqui" } },
  "automacao": {
    "contaId": "<id da conta>",
    "keyword": "quero",
    "mensagem": "toma o link: ...",
    "exigirFollow": true
  }
}

quando em horário de Brasília. Omitir publica agora; data ilegível devolve 400.

Contas, automações e caixa

GET    /api/contas
GET    /api/conectar/:plataforma      → { url } pra mandar o usuário
POST   /api/contas/:id/assinar        (retenta o webhook)
DELETE /api/contas/:id

GET    /api/automacoes
POST   /api/automacoes
DELETE /api/automacoes/:id

GET  /api/caixa
GET  /api/caixa/:id
POST /api/caixa/:id/responder         → { texto }

Erros

Erro de validação volta em 422 com { erro, detalhes: [...] }, uma linha por problema e com a plataforma na frente — tiktok: aceita 1 vídeo, veio 0. Coisa que passa mas merece atenção volta em avisos, e não impede o agendamento.