REST API: publicar posts via código

A REST API do Fala Cheese deixa você integrar o motor de publicação ao seu stack existente — n8n, Make, scripts próprios, etc. Disponível nos planos Pro e Agência.

Autenticação

Toda chamada exige uma API key no header Authorization: Bearer fc_live_....

Pra criar uma:

/app/settings → seção API keys
Clica em Nova chave
Copia o valor exibido (formato fc_live_<64 chars hex>)

A chave aparece uma única vez — depois ela fica guardada como hash no banco e não tem como recuperar. Se perder, revoga e cria nova.

Publicar um post

curl -X POST https://app.falacheese.com.br/api/v1/posts \
  -H "Authorization: Bearer fc_live_abc...123" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Texto do post.",
    "socialAccountIds": ["acc_xyz"],
    "publishNow": true
  }'

Resposta:

{
  "ok": true,
  "post": { "id": "post_...", "status": "publishing" },
  "publishResults": [
    { "socialAccountId": "acc_xyz", "status": "fulfilled" }
  ]
}

Agendar

Mesma chamada, mas em vez de publishNow: true use scheduledAt: "2026-06-01T12:00:00.000Z" (ISO 8601, UTC).

Listar contas

curl https://app.falacheese.com.br/api/v1/accounts \
  -H "Authorization: Bearer fc_live_..."

Você precisa do socialAccountId retornado aqui pra passar no socialAccountIds ao publicar.

OpenAPI

A spec completa em OpenAPI 3.1 está em /api/openapi. Você pode importar no Postman, Insomnia, ou em ferramentas como n8n/Make pra ter autocomplete dos endpoints.

Sample workflows

n8n setup — em breve
Make setup — em breve

Os repositórios de exemplo estão em docs/integrations/n8n.md e docs/integrations/make.md no repo do app, mostrando como mandar do RSS, Notion ou webhook pro Fala Cheese.

Rate limits

30 req/min por API key
1000 req/dia por API key

Se atingir, responde 429 com header Retry-After. Pra volume maior, fala com a gente em contato@falacheese.com.br que avaliamos plano Agência customizado.

Revogar chave

/app/settings → API keys → três pontinhos → Revogar. A revogação é imediata — próxima request com a key responde 401.