Como Usar a API do FlipLink para Integrações

Se você gerencia dezenas (ou centenas) de flipbooks, fazer tudo manualmente pelo painel se torna cansativo rápido. É aí que a API do FlipLink entra — ela permite criar flipbooks programaticamente, gerenciar publicações, extrair analytics e conectar o FlipLink às suas ferramentas e fluxos de trabalho existentes.

Seja você um desenvolvedor construindo uma integração personalizada ou um líder de equipe buscando automatizar tarefas repetitivas, este guia mostra o que a API pode fazer e como começar.

O que a API do FlipLink permite fazer

A API REST do FlipLink dá acesso programático às mesmas funcionalidades disponíveis no painel. Em vez de clicar pela interface, você envia requisições HTTP e recebe respostas JSON estruturadas.

Veja o que você pode realizar:

• Criar flipbooks e documentos a partir de arquivos PDF (upload ou URL) sem abrir o painel
• Atualizar configurações de publicações como metadados, formulários de captura de leads, skins e controles de acesso
• Extrair dados de engajamento — contagens de visualização por flipbook, mais exportações completas de leads e vendas
• Gerenciar publicações em escala — criar, atualizar ou excluir dezenas de flipbooks em um único script
• Disparar workflows com webhooks por flipbook que são acionados quando um novo lead é capturado

Para uma visão completa dos recursos programáticos, confira a página do recurso Acesso à API — e para os endpoints exatos, parâmetros e exemplos ao vivo, a referência da API.

Obtendo sua API key

Antes de fazer qualquer chamada à API, você precisa de uma API key. Veja como obtê-la:

1. Faça login no painel do FlipLink em go.fliplink.me
2. Navegue até Configurações → Acesso à API
3. Clique em Gerar API Key
4. Copie a chave e armazene-a com segurança — trate-a como uma senha

Sua API key autentica cada requisição. Inclua-a no header X-Api-Key:

X-Api-Key: YOUR_API_KEY

Importante: Nunca exponha sua API key em código do lado do cliente ou repositórios públicos. Mantenha-a no lado do servidor ou em variáveis de ambiente. A seção de Autenticação da referência da API cobre isso por completo.

Casos de uso comuns da API

Criação de flipbooks em massa

Tem uma pasta com 50 catálogos de produtos que precisam virar flipbooks? Em vez de fazer upload um por um, escreva um script que percorre seus PDFs e chama o endpoint de criação para cada um. Combine com Operações em Massa para máxima eficiência.

Puxando analytics para seu próprio painel

Se você acompanha performance de marketing em uma ferramenta centralizada — um painel personalizado, Google Sheets ou plataforma de BI — pode extrair dados de visualização e engajamento do FlipLink via API e consolidar junto com suas outras métricas.

Gerenciamento de publicações em escala

Precisa atualizar a identidade visual de todos os seus flipbooks após um rebranding? Ou arquivar os catálogos do trimestre passado? A API permite fazer essas atualizações em lote sem clicar em cada publicação individualmente.

Conectando a plataformas de automação

Combine a API com ferramentas como Zapier, Pabbly ou Make para construir workflows sem código. Por exemplo, crie automaticamente um flipbook sempre que um novo PDF for adicionado a uma pasta específica do Google Drive. Veja nosso guia sobre como conectar o FlipLink ao Zapier, Pabbly e Make para instruções passo a passo, ou explore o recurso Automação e Integrações.

🚀

Experimente o FlipLink Grátis

Converta seu PDF em segundos. Sem cadastro, sem cartão de crédito — basta enviar o arquivo.

Drop your PDF here or click to browse

Máx 40MB

Os planos pagos a partir de $39 aumentam esse limite para 150 MB.

Exemplo: criando um flipbook via API

Aqui está um exemplo básico usando curl para criar um novo flipbook a partir de um upload de PDF:

curl -X POST 'https://go.fliplink.me/api/create-by-file' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@product-catalog.pdf' \
  -F 'Name=Spring Product Catalog' \
  -F 'Title=Spring Product Catalog' \
  -F 'DocType=Flipbook'

A API retorna uma resposta JSON — {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} — com o ID da publicação e a URL de compartilhamento que você precisa para distribuir o flipbook imediatamente. Já tem o PDF online? Troque por POST /api/create-by-url e passe FileURL em vez de File.

Você pode fazer o mesmo em Python, Node.js ou qualquer linguagem que suporte requisições HTTP. A API é REST padrão com corpos form-urlencoded (ou multipart), então funciona com qualquer stack que você já esteja usando. Uma coisa para lembrar: erros de aplicação voltam como HTTP 200 com Result: "ERROR" (apenas falhas de autenticação retornam 401), então verifique o campo Result.

Endpoints disponíveis da API

Esta é uma pequena amostra — o catálogo completo de mais de 80 endpoints, cada um com parâmetros e um console Try-It ao vivo, fica na referência da API.

Todos os endpoints retornam JSON. O limite de taxa é de 300 requisições por minuto por chave de API. Veja a referência da API para cada endpoint, seus parâmetros, o modelo de erro e os caminhos de dependência.

Quando usar a API vs. o painel

Nem tudo precisa de uma chamada de API. Aqui está um framework simples de decisão:

• Use o painel quando estiver criando um único flipbook, ajustando configurações de design visualmente ou explorando analytics casualmente
• Use a API quando estiver lidando com mais de cinco publicações de uma vez, integrando com outros sistemas ou automatizando tarefas recorrentes
• Use plataformas de automação (Zapier/Make/Pabbly) quando quiser o poder da API sem escrever código

Para equipes gerenciando catálogos de produtos ou qualquer conteúdo que atualiza regularmente, a API se paga em tempo economizado após a primeira execução em lote.

Comece a construir

A API do FlipLink transforma trabalho manual em workflows automatizados. Seja sincronizando analytics com um painel, criando flipbooks em massa a partir de um pipeline de conteúdo ou conectando o FlipLink ao seu CRM — a API dá o controle para construir exatamente o que você precisa.

Pronto para começar? Crie sua conta gratuita no FlipLink, gere sua API key e abra a referência da API para testar cada endpoint ao vivo no seu navegador. Confira nossos preços para ver o que está incluído com o acesso à API.