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 sem abrir o painel
• Atualizar configurações de publicações como títulos, descrições, formulários de captura de leads e controles de acesso
• Extrair analytics — visualizações, visitantes únicos, tempo médio por página e mais
• Gerenciar publicações em massa — arquivar, excluir ou atualizar dezenas de flipbooks em um único script
• Disparar workflows baseados em eventos como novos leads capturados ou limites de visualização atingidos

Para uma visão completa dos recursos programáticos, confira a página do recurso Acesso à 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 → 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 Authorization:

Authorization: Bearer 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.

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.

Exemplo: Criando um Flipbook via API

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

curl -X POST https://api.fliplink.me/v1/publications \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@product-catalog.pdf" \
  -F "title=Spring Product Catalog" \
  -F "type=flipbook" \
  -F "visibility=public"

A API retorna uma resposta JSON com o ID da publicação, código de incorporação e URL de compartilhamento — tudo que você precisa para distribuir o flipbook imediatamente.

Você também pode fazer o mesmo em Python, Node.js ou qualquer linguagem que suporte requisições HTTP. A API é REST padrão, então funciona com qualquer stack que você já esteja usando.

Endpoints Disponíveis da API

Todos os endpoints retornam JSON e seguem códigos de status HTTP padrão. Limites de taxa se aplicam — consulte a documentação da API no seu painel para os limites atuais.

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 e gere sua API key hoje. Confira nossos preços para ver o que está incluído com o acesso à API.