Ir para o conteúdo
CL3 Marketing Orçamento grátis

O que é API e quando o site da sua empresa precisa de uma


Em 30 segundos

  • API é uma porta combinada para um sistema pedir dados ou ações a outro, sem digitação manual.
  • Exemplos comuns: formulário no CRM, estoque da loja no ERP, frete calculado na hora e nota fiscal emitida sozinha.
  • Antes de orçar, pergunte se a outra ponta tem API, se cobra pelo uso, se há documentação, quem mantém e o que muda quando a API muda.
  • Site institucional que só recebe contatos não precisa de API; ela se paga quando alguém digita dado repetido todos os dias.

O que é API? É o jeito de um sistema conversar com outro: o site faz um pedido e a outra ponta responde, sem ninguém digitar. Assim o formulário cai no CRM, o estoque da loja acompanha o ERP, o frete aparece na hora e a nota fiscal sai sozinha.

A sigla assusta, mas a ideia é simples e o dono da empresa já a usa sem perceber: quando o aplicativo do banco mostra o saldo, ele pergunta ao sistema do banco, que responde. O que importa para quem contrata um site ou um sistema é saber quando uma integração por API resolve um problema real e o que perguntar antes de pedir o orçamento, porque é aí que prazo e preço mudam. Abaixo, quatro exemplos do dia a dia, as perguntas de conferência e o que a criação de sistemas web precisa deixar combinado.

O que é API, em linguagem de quem toca uma empresa?

API é uma porta combinada: um sistema oferece certos pedidos que outros sistemas podem fazer, e responde no mesmo formato sempre. Pense no garçom: você não entra na cozinha, faz o pedido pelo cardápio e recebe o prato. O cardápio é a documentação da API, o pedido é a chamada, e o prato é a resposta.

Três ideias bastam para conversar com um fornecedor. Primeiro, a API pertence a quem a oferece: a empresa do CRM, do meio de pagamento ou da transportadora decide o que libera, quanto cobra e como muda. Segundo, nada acontece por mágica: alguém precisa programar a ligação entre o seu site e essa porta. Terceiro, a ligação tem manutenção, porque a outra ponta pode mudar. Um exemplo de documentação real é a da Meta: a API de Conversões conecta dados de marketing do anunciante aos sistemas da Meta, e os eventos são enviados do servidor por requisições POST. É o mesmo princípio, com outro assunto.

Quais exemplos de integração por API aparecem numa empresa comum?

Os quatro mais comuns são o formulário ligado ao CRM, o estoque da loja ligado ao ERP, o frete calculado na hora e a nota fiscal emitida sozinha. Em todos, a API troca o trabalho manual por uma conversa entre sistemas.

SituaçãoSem APICom APIO que precisa existir na outra ponta
Formulário do site e CRMAlguém copia o contato do e-mail para o CRMO contato aparece no CRM com a origem registradaCRM com API aberta para criar contato
Estoque da loja e ERPEstoque atualizado à mão, risco de vender o que não temCada venda baixa o estoque e cada entrada o aumentaERP com API de produtos e saldo
Frete na horaCliente pede o preço e espera respostaO carrinho mostra prazo e valor do envioTransportadora ou agregador com API de cotação
Nota fiscalAlguém emite a nota depois do pedidoO pedido pago vira nota sem digitaçãoEmissor de notas com API e certificado da empresa

Cada linha tem um texto próprio no blog. Para o primeiro caso, o exemplo do formulário até a venda está em site com integração com CRM, e as cinco perguntas antes de contratar a ligação estão em site e CRM juntos. Para estoque, preço e pedido, o checklist está em site integrado com ERP. Para nota fiscal, veja as seis etapas para o pedido virar nota sem digitar, e para quem vende em vários lugares, loja virtual integrada com marketplaces.

O que perguntar antes de orçar uma integração por API?

Pergunte cinco coisas: se a outra ponta tem API, se ela cobra pelo uso, se há documentação, quem faz a manutenção e o que acontece quando a API muda. Cada resposta mexe no prazo e no preço do projeto.

  1. A outra ponta tem API? Nem todo sistema tem. Software antigo, instalado no computador da empresa, costuma não ter, e a integração vira importação de arquivo, que é mais lenta e mais frágil.
  2. Ela cobra pelo uso? Alguns serviços liberam a API no plano básico, outros só no pago, outros cobram por chamada. Confira o contrato do serviço, não o do site; é custo mensal que entra na conta da empresa, à parte do projeto.
  3. Existe documentação? Sem texto que explique cada pedido e cada resposta, o programador descobre no tentativa e erro, e o prazo cresce.
  4. Quem acompanha mudanças? Quando o fornecedor muda a API, a ligação pode parar. Alguém precisa receber o aviso e ajustar; combine isso por escrito.
  5. Há ambiente de teste? Boas APIs oferecem um lugar para testar sem mexer em dados reais. Sem isso, o teste de uma nota fiscal ou de um pagamento fica arriscado.

Uma sexta pergunta, que tem a ver com a primeira, é sobre os dados que passam pela ponte. Se há dado pessoal de clientes, a integração precisa respeitar a LGPD, e o texto nota fiscal na criação de site: o que perguntar ao fornecedor antes de pagar mostra o tipo de pergunta que vale fazer a quem constrói a ligação.

Por que a API muda prazo e preço de um projeto?

Porque cada integração é um mini-projeto com três partes: ler a documentação, programar a ligação e testar os casos de erro. Um site simples, sem integração, tem prazo e preço previsíveis. Cada ponta adicional traz uma incerteza: a documentação é boa? A API é estável? O teste libera ou depende de aprovação do fornecedor? Esse último ponto é o que mais atrasa.

Por isso as propostas sérias descrevem as integrações pelo nome e dizem o que está dentro e fora do prazo. Se a proposta fala em "integração com sistemas" sem listar quais, o orçamento está incompleto. Para ver o peso de uma integração num projeto real, o caso de uma imobiliária, com busca de imóveis e ligação com outros sistemas, está em quanto custa um site para imobiliária.

Quando o site não precisa de API nenhuma

Nem todo site precisa de integração, e vender uma onde não há necessidade é um sinal de alerta. O site institucional que recebe contatos por formulário e responde por e-mail ou WhatsApp funciona sem API. Também não precisa de API a loja que vende poucos produtos e atualiza o estoque à mão, no painel. O ponto de virada é o volume: quando alguém passa o dia copiando dado de um sistema para outro, a integração começa a se pagar.

Uma regra simples: se você faz a mesma digitação mais de uma vez por dia, ou se erros de digitação já custaram venda, pense em integração. Se não, um site simples resolve, e a página site com login de usuário mostra o que acontece quando o projeto passa de página para sistema.

Como a CL3 combina integrações por API na proposta

A CL3 faz sistemas web e as integrações que eles pedem, e começa pela conversa sobre o que hoje é digitado à mão. Cada integração entra na proposta por escrito com nome, o que ela faz, o que depende da outra ponta (documentação, plano, aprovação) e o que fica de fora. O valor é fechado, a prévia é aprovada num endereço provisório antes de ir ao ar, e o domínio e as contas de serviço ficam no CNPJ do cliente, para que a ligação continue sua mesmo que mude o fornecedor.

Se a integração envolve loja virtual, a CL3 começa pela escolha da plataforma, e o caminho passa pela escolha da plataforma, e o texto loja virtual Shopify no Brasil mostra o que funciona pronto e o que pede adaptação. Para quem ainda não sabe se precisa de um sistema, a análise de site grátis dá uma nota de 0 a 100 ao que existe hoje, sem cadastro, e ajuda a separar o que é problema do site do que é problema do processo.

Próximo passo: listar as ligações que você quer

Faça uma lista de duas colunas: de um lado, os sistemas que a empresa usa hoje (CRM, ERP, emissor de nota, transportadora, meio de pagamento); do outro, o que você quer que passe de um para o outro. Marque quais têm API e em qual plano. Com isso na mão, o orçamento sai mais rápido e mais justo.

Com essa lista, a CL3 consegue dizer o que cabe no prazo e o que depende da outra ponta. Para começar, veja a página de sistemas web sob medida e conte o caso pela página de contato.

Perguntas frequentes

Toda ferramenta que a empresa usa tem API?

Não. Ferramentas modernas na nuvem costumam ter, mas software antigo, instalado em computador da empresa, muitas vezes não tem. Nesse caso a integração vira importação de arquivo, mais lenta e mais frágil. Por isso a primeira pergunta de qualquer integração com ERP é se existe API.

A integração por API tem custo mensal?

Pode ter, e é um custo à parte do projeto. Alguns serviços liberam a API no plano básico, outros só no pago e outros cobram por chamada. Confira o contrato do serviço da outra ponta, e não o do seu site, antes de fechar o escopo da integração.

O que acontece com o site quando a API do fornecedor muda?

A ligação pode parar de funcionar até alguém ajustar o código. Por isso a manutenção da integração precisa estar combinada por escrito, com quem recebe o aviso do fornecedor e em quanto tempo corrige. A CL3 inclui isso na proposta de sistemas web.

Fontes citadas

Os documentos em que este artigo se apoia, na ordem em que aparecem no texto. Abra e confira.

  1. developers.facebook.com Meta para desenvolvedores: API de Conversões
Compartilhar no WhatsApp Marcar a CL3 como fonte preferida no Google

Pronto para ter um site que trabalha pela sua empresa?

Conte o que a sua empresa faz e a gente responde com uma proposta clara, sem enrolação.

Solicitar atendimento