API REST do FormGuru — primeiros passos

A API REST do FormGuru permite que você acesse seus dados por código, integrando o FormGuru a sistemas próprios, planilhas, dashboards ou qualquer ferramenta capaz de fazer uma requisição HTTP. Os endpoints ficam sob /api/v1 e a autenticação é feita por uma chave de API. Este guia mostra o caminho dos primeiros passos: gerar a chave, fazer a primeira chamada e seguir as boas práticas de segurança.

O que dá pra fazer com a API

Pela API REST você consegue, entre outras coisas:

• Listar seus formulários — recuperar os formulários da sua conta de forma programática.
• Puxar respostas — buscar as respostas enviadas a um formulário para processar em outro sistema.
• Cruzar dados — alimentar dashboards, planilhas ou um CRM próprio com os dados do FormGuru.

A API é uma boa opção quando você precisa buscar dados sob demanda (ao contrário dos Webhooks, que enviam os dados automaticamente a cada nova resposta). Em muitos casos os dois se complementam: webhooks para receber em tempo real, API para consultar o histórico.

A lista completa de endpoints, parâmetros e formatos de resposta está na documentação técnica em /docs/api. Este artigo cobre só o essencial para você começar.

1. Gere uma chave de API

1. Entre na sua conta do FormGuru.
2. Abra as Configurações e vá até a área de API / chaves de API.
3. Clique para gerar uma nova chave.
4. Copie a chave e guarde em local seguro. Por segurança, ela costuma ser exibida apenas no momento da criação — se você perdê-la, será preciso gerar uma nova.

A chave funciona como uma senha: quem tiver acesso a ela pode acessar os dados da sua conta. Por isso, trate-a com o mesmo cuidado.

2. Autentique com Bearer token

A autenticação é feita enviando a sua chave no cabeçalho Authorization de cada requisição, no formato Bearer token:

Authorization: Bearer SUA_CHAVE_DE_API

Toda chamada a um endpoint sob /api/v1 precisa incluir esse cabeçalho. Sem ele, ou com uma chave inválida, a requisição é recusada.

3. Faça sua primeira requisição

O exemplo abaixo usa curl para chamar a API. Substitua SUA_CHAVE_DE_API pela chave que você gerou e o caminho do endpoint pelo que estiver descrito na documentação:

curl https://formguru.com.br/api/v1/... \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json"

A resposta vem em JSON, pronta para ser consumida pela sua aplicação. Consulte /docs/api para os caminhos exatos de cada endpoint (listar formulários, puxar respostas etc.) e os parâmetros aceitos.

Boas práticas de segurança

• Nunca exponha a chave no front-end. Não a coloque em código de página, JavaScript do navegador ou apps móveis — qualquer pessoa conseguiria lê-la. Faça as chamadas a partir do seu servidor.
• Não versione a chave. Evite comitá-la no Git. Use variáveis de ambiente ou um cofre de segredos.
• Revogue chaves comprometidas. Se desconfiar que uma chave vazou, gere uma nova e descarte a antiga na área de API das Configurações.
• Use uma chave por integração, quando possível, para conseguir revogar apenas o acesso afetado sem derrubar as demais.

Dúvidas comuns

Preciso saber programar para usar a API?

Sim, a API REST é voltada para usos técnicos. Se você quer apenas receber as respostas em outra ferramenta sem escrever código, considere os Webhooks ou as integrações nativas (Google Sheets, e-mail marketing etc.).

Qual a diferença entre a API e o MCP?

A API REST é para integrar o FormGuru a sistemas e código. O MCP Server conecta o FormGuru a assistentes de IA como o Claude, permitindo criar formulários, ver respostas e estatísticas por linguagem natural. Escolha conforme o seu objetivo.

Onde encontro a lista de endpoints?

Na documentação completa em /docs/api, com todos os endpoints sob /api/v1, parâmetros e exemplos de resposta.