API do Don Websend

API REST para integrações — feita para o Don Poster criar pastas na galeria, subir imagens/reels das páginas e agendar as postagens automaticamente.

Base URL

https://donwebsend.marketfb.com

Autenticação

Todas as chamadas em /api usam o cabeçalho X-API-Key. A chave fica no dashboard em Configurações → API & Tokens.

X-API-Key: SUA_API_KEY

Fluxo recomendado para o Don Poster

1️⃣ Cria (ou garante) a pasta da página → 2️⃣ sobe as mídias para a pasta → 3️⃣ (opcional) agenda direto. Se preferir só abastecer a galeria, as Campanhas do dashboard cuidam do agendamento usando a pasta.

POST/api/pastas

Cria uma pasta na galeria. Idempotente por nome no mesmo nível: se a pasta já existir, devolve a existente — pode chamar sempre antes de subir. Para criar uma subpasta, envie o campo opcional pastaPaiId com o id da pasta superior.

curl -X POST "{BASE}/api/pastas" \
  -H "X-API-Key: {KEY}" -H "Content-Type: application/json" \
  -d '{"nome": "KELLY MOREIRA IMAGENS"}'

// → { "id": "9b1c…", "nome": "KELLY MOREIRA IMAGENS", "criadoEm": "…" }

curl -X POST "{BASE}/api/pastas" \
  -H "X-API-Key: {KEY}" -H "Content-Type: application/json" \
  -d '{"nome": "REELS", "pastaPaiId": "ID-DA-PASTA-SUPERIOR"}'

GET/api/pastas

Lista as pastas com a contagem de itens.

POST/api/import

Sobe uma mídia (imagem ou reel) para a galeria — e, opcionalmente, já agenda o post.

Exemplo em Node.js (upload para a pasta da página):

const fs = require('fs');

const resposta = await fetch('{BASE}/api/import', {
  method: 'POST',
  headers: { 'X-API-Key': '{KEY}', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    nomeArquivo: 'kelly-01.jpg',
    conteudoBase64: fs.readFileSync('kelly-01.jpg').toString('base64'),
    pasta: 'KELLY MOREIRA IMAGENS',
    legenda: 'Bom dia! ☀️'
  })
});
const { midia, post } = await resposta.json();

A resposta preserva os dados da mídia e inclui o endereço público permanente:

{
  "midia": {
    "id": "ID-DA-MIDIA",
    "arquivo": "ID-DA-MIDIA.mp4",
    "urlPublica": "https://donwebsend.marketfb.com/public-media/ID-DA-MIDIA.mp4"
  },
  "post": null
}

GET/public-media/:arquivo

/media/:arquivo continua sendo a rota privada usada pelo painel e exige autenticação. /public-media/:arquivo é o link público de leitura para incorporar a mídia em sites externos. Ele não usa chave de API, aceita GET, HEAD e reprodução parcial de vídeos por HTTP Range.

Exemplo de incorporação no WordPress:

<video controls preload="metadata" playsinline>
  <source
    src="https://donwebsend.marketfb.com/public-media/ID-DA-MIDIA.mp4"
    type="video/mp4"
  >
</video>

GET/api/accounts

Lista os perfis conectados e suas páginas — use para descobrir perfilId e paginaId.

[
  {
    "id": "10000000000001",          // ← perfilId
    "nome": "Kelly Moreira",
    "paginas": [
      { "id": "11234352375253", "nome": "Kelly Moreira", "conectada": true }   // ← paginaId
    ]
  }
]

POST/api/posts

Agenda um post com uma mídia que já está na galeria.

Outros endpoints

Modo local: pasta imports/

Rodando na mesma máquina, o Don Poster também pode soltar arquivos em imports/ com um manifesto JSON (varredura a cada 30 s):

// imports/lote-kelly.json
[
  { "arquivo": "kelly-01.jpg", "pasta": "KELLY MOREIRA IMAGENS", "legenda": "Bom dia! ☀️" },
  { "arquivo": "kelly-reel-01.mp4", "pasta": "KELLY MOREIRA REELS", "tipo": "reel",
    "perfilId": "10000000000001", "paginaId": "11234352375253",
    "agendadoPara": "2026-07-10T19:00:00" }
]

Erros

Respostas de erro vêm como { "erro": "mensagem" } com status 400 (dados inválidos) ou 401 (sem autenticação — confira o X-API-Key).