Em resumo: API (Application Programming Interface, ou interface de programação de aplicações) é um conjunto de regras que permite que um sistema peça informações ou ações a outro de forma automática. É ela que faz a loja virtual calcular o frete com a transportadora, o banco gerar um PIX e o site deixar você entrar "com o Google".
Muita gente ouve a sigla em reuniões de tecnologia sem saber exatamente o que é API. Este guia explica o conceito sem jargão, mostra exemplos que você usa todos os dias e o que perguntar a um fornecedor antes de contratar qualquer software.
A analogia do restaurante
A explicação mais usada, e ainda uma das melhores, é a do garçom:
- Você (um sistema) quer um prato;
- A cozinha (outro sistema) sabe preparar o prato, mas você não entra lá;
- O garçom (a API) leva o pedido em um formato combinado, o cardápio, e traz a resposta.
Você não precisa saber como a cozinha funciona. Basta pedir do jeito certo. A API faz o mesmo entre sistemas: define o que pode ser pedido, em que formato e o que volta como resposta. A AWS descreve as APIs como mecanismos que permitem que dois componentes de software se comuniquem usando um conjunto de definições e protocolos.
Exemplos de API que você usa todos os dias
- Cálculo de frete: ao digitar o CEP em uma loja, o site consulta a API da transportadora e mostra prazo e preço.
- Pagamento com PIX ou cartão: a loja chama a API do banco ou do intermediador de pagamento, que gera a cobrança e avisa quando ela foi paga. O PIX, criado pelo Banco Central, é um bom exemplo de ecossistema em que bancos e empresas trocam dados por interfaces padronizadas.
- "Entrar com Google": o site pergunta ao Google se você é você, sem nunca ver a sua senha.
- Mapas em apps de entrega: o aplicativo usa a API de um serviço de mapas para desenhar a rota.
- Formulários que preenchem o endereço sozinhos: consultam uma API de CEP.
"Woman Developer", Christina Morillo (domínio público, via stocksnap).
O que é API do ponto de vista técnico
Por trás da analogia, o funcionamento segue quase sempre os mesmos passos:
- O sistema A faz uma requisição: "me diga o saldo de estoque do produto 123".
- A requisição leva uma credencial, uma espécie de crachá que prova que A tem permissão.
- O sistema B processa o pedido.
- B devolve uma resposta em um formato padronizado, geralmente JSON, um texto estruturado:
{"produto": 123, "saldo": 42}.
Tudo isso acontece em frações de segundo, milhares de vezes por dia, sem ninguém clicar em nada. Para que times diferentes consigam usar a mesma API sem ambiguidade, muitas empresas descrevem suas interfaces com a especificação OpenAPI, um padrão aberto que documenta endereços, campos e respostas.
Tipos de API mais comuns
| Tipo | O que é | Onde aparece |
|---|---|---|
| REST | O estilo mais usado na web, simples e flexível | A grande maioria dos sistemas modernos |
| Webhook | O sistema avisa o outro quando algo acontece, em vez de esperar ser perguntado | Confirmação de pagamento, novo pedido em marketplace |
| GraphQL | Permite pedir exatamente os campos desejados em uma consulta | Aplicativos com muitas telas e dados |
| SOAP | Padrão mais antigo e rígido, baseado em XML | Sistemas bancários, governo e legados |
A Red Hat lembra que as APIs também podem ser privadas (usadas só dentro da empresa), de parceiros ou públicas, e essa escolha define quem pode acessar e com quais regras.
Por que APIs importam para a sua empresa
Sem API, sistemas diferentes não conversam, e alguém precisa copiar dados de um para o outro. Com API:
- O pedido do site entra sozinho no ERP;
- O estoque é atualizado em todos os canais de venda ao mesmo tempo;
- A nota fiscal é emitida sem digitação;
- Os relatórios juntam dados de várias fontes automaticamente.
Por isso, uma das perguntas mais importantes ao escolher qualquer software é: "ele tem API documentada?" Um sistema sem API vira uma ilha, e ilhas geram retrabalho. Também vale perguntar se há limites de uso, como a autenticação funciona e se existe ambiente de testes.
API é segura?
Pode e deve ser. Boas APIs exigem autenticação por chaves ou tokens, usam conexão criptografada (HTTPS), limitam quantas requisições cada cliente pode fazer e registram quem acessou o quê. Os riscos aparecem quando chaves de acesso ficam expostas em código ou planilhas, ou quando a API devolve mais dados do que deveria. Revisar permissões periodicamente é tão importante quanto construir a integração.
Como a TrustSoft trabalha com APIs
Na maioria dos projetos de integração, o primeiro passo é mapear quais sistemas precisam trocar dados e o que cada um oferece. Depois, desenhamos contratos claros, tratamento de falhas e monitoramento, em ciclos curtos com entrega funcional. Veja como fazemos integração de sistemas e APIs.
Perguntas frequentes
API é um programa que eu instalo?
Não. A API é uma porta de acesso de um sistema que já existe. Você usa essa porta por meio de outro sistema ou de uma integração construída para isso.
Toda empresa pode ter uma API?
Sim. Empresas criam APIs para que clientes e parceiros consultem pedidos, estoque ou preços de forma automática, algo comum em distribuidoras e indústrias que vendem para revendedores.
E quando o sistema não tem API?
Existem alternativas, como troca de arquivos agendada, acesso controlado ao banco de dados ou robôs que operam a tela (RPA). Cada uma tem prós e contras, explicados em Integração de sistemas: API, webhook, fila ou arquivo?.
Qual a diferença entre API e integração?
A API é a porta; a integração é o trabalho de conectar dois sistemas por essa porta, com regras de negócio, tratamento de erros e monitoramento.
Seus sistemas não conversam e a equipe vive copiando dados? Fale com um especialista em um diagnóstico gratuito.
Imagens: capa: "Coding Programming", Sai Kiran Anagani (domínio público, via stocksnap); imagem 1: "Woman Developer", Christina Morillo (domínio público, via stocksnap).
