API sem medo (explicada pra quem não programa)

O que é uma API, o que é a sua chave fc_live_ e como fazer seu primeiro request — sem precisar virar dev.

"API" assusta quem não programa. Não deveria. Em 5 minutos você entende o conceito — e nunca mais se intimida.

O garçom e a cozinha

Pense num restaurante:

A cozinha é o Fala Cheese por dentro: onde os posts são criados, agendados e publicados.
Você é o cliente. Não entra na cozinha.
O garçom é a API: leva pedidos num formato que a cozinha entende e traz o resultado de volta.

API é só isso: um garçom que aceita pedidos por escrito. "Crie um post", "liste minhas contas", "agende pra terça às 9h". Qualquer ferramenta que saiba escrever o pedido (n8n, Make, um script) pode pedir por você.

A chave fc_live_

O garçom só atende quem prova que é cliente da casa. Essa prova é a sua chave de API — um código que começa com fc_live_, gerado em Configurações no app. A API é exclusiva dos planos pagos.

Três regras de segurança, inegociáveis:

A chave é uma senha. Quem tem a chave publica em nome das suas contas.
Nunca cole a chave em lugar público — post, print, repositório, grupo. Se vazou, revogue na hora e gere outra.
Guarde no cofre da ferramenta (campo de credencial do n8n/Make), nunca solta no meio do fluxo.

Seu primeiro pedido

Um "request" é o pedido por escrito. Este aqui cria um rascunho de post:

curl -X POST https://app.falacheese.com.br/api/v1/posts \
  -H "Authorization: Bearer fc_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"content": "Meu primeiro post via API!", "status": "draft"}'

Traduzindo linha a linha:

curl -X POST — "garçom, anota um pedido novo"
Authorization: Bearer — "aqui está minha chave, sou cliente"
-d '{...}' — o pedido em si: o texto do post e o status (rascunho)

A resposta volta em JSON confirmando que o rascunho existe. Pronto: você acabou de usar uma API. A lista completa de pedidos possíveis está em falacheese.com.br/docs.

Por que isso importa

Tudo que você vai montar nas próximas aulas — fluxos no n8n, cenários no Make, webhooks — é combinação de pedidos como esse. Quem entende o garçom monta qualquer automação.

Regra pra levar: API é um garçom, a chave é sua identidade e request é o pedido por escrito. O resto é detalhe que a documentação resolve.