Entenda a tecnologia ·
O que é uma API? Explicação simples para donos de empresa
API é o jeito de dois sistemas conversarem sem ninguém digitar duas vezes. Entenda com um exemplo do dia a dia e saiba o que perguntar ao seu fornecedor.
Por Kayo Vidal, Desenvolvedor e fundador da KVM
Publicado em · Atualizado em
Resposta curta: uma API é o jeito que um sistema oferece para que outro sistema converse com ele. Em vez de uma pessoa abrir uma tela, ler um número e digitar em outro lugar, o programa pede a informação e recebe a resposta sozinho. Para uma empresa, isso significa menos digitação, menos erro e informação igual em todos os lugares.
O que é uma API?
API é a sigla, em inglês, para Application Programming Interface. Segundo o glossário do MDN Web Docs, é um conjunto de características e regras de uma aplicação que permite interagir com ela por meio de software, e não por uma tela feita para uma pessoa. O mesmo glossário descreve a API como uma espécie de contrato entre quem oferece a aplicação e os outros programas que a usam.
Em linguagem de empresa: é a porta de serviço de um sistema. A porta da frente é a tela, que as pessoas usam. A porta de serviço é a API, que outros sistemas usam.
A analogia do garçom
Você não entra na cozinha para pegar o prato. Você pede ao garçom, ele leva o pedido e volta com a comida. Você não precisa saber como a cozinha funciona. Só precisa saber como fazer o pedido.
Uma API faz isso entre dois sistemas: um pede, ela leva o pedido, o outro responde. Quem pede não precisa conhecer o que há por dentro de quem responde.
Onde uma empresa usa API sem perceber
- Site mostrando o estoque real. O site pergunta ao sistema do depósito quantas unidades existem e mostra a resposta, sem ninguém digitar.
- Orçamento que vira PDF e vai por e-mail. O sistema de orçamentos pede a outro programa que gere o documento e envie.
- Pedido do WhatsApp indo para a lista de pedidos. A mensagem chega e um programa registra o pedido no sistema.
- Pagamento e emissão de nota. O sistema da empresa pede a um serviço de terceiros que cobre ou emita o documento.
O que muda na rotina quando os sistemas conversam
| Situação | Sem API | Com API |
|---|---|---|
| Pedido que chega por um canal | Alguém copia para a planilha | O pedido aparece na lista sozinho |
| Estoque no site | Atualizado à mão, quando alguém lembra | Igual ao do sistema do depósito |
| Relatório do mês | Alguém junta dados de vários lugares | Os dados já chegam reunidos |
| Erro de digitação | Pode acontecer em cada cópia | Há uma só digitação, na origem |
O que perguntar ao fornecedor
- O sistema que vamos usar tem API? Há documentação?
- Quais informações dá para ler e quais dá para gravar?
- Como o acesso é controlado e quem pode fazer cada coisa?
- O que acontece se o outro sistema ficar fora do ar por algumas horas?
- Quem cuida da integração depois que ela entra no ar?
A última pergunta importa mais do que parece. Uma integração depende de sistemas de terceiros que mudam ao longo do tempo, então ela precisa de manutenção. Veja por que no artigo Por que sistema sem manutenção para de funcionar.
O que uma API não faz
Uma API não resolve um processo mal desenhado. Se a empresa não sabe quem aprova o quê, ligar dois sistemas só faz o problema andar mais rápido. Primeiro descreva o processo, depois decida o que ligar.
Se você está avaliando se vale a pena construir algo sob medida para isso, leia Sistema sob medida ou software pronto.
Como este artigo foi feito
A definição de API segue o glossário do MDN Web Docs, listado nas fontes. Os exemplos são situações comuns em empresas e não descrevem clientes da KVM System. Não usamos estatísticas, porque nenhuma delas é necessária para explicar o conceito.
Perguntas frequentes
O que significa a sigla API?
API vem do inglês Application Programming Interface, em português interface de programação de aplicações. É o conjunto de regras que um sistema oferece para que outros programas conversem com ele.
API é a mesma coisa que integração?
Quase. A integração é o resultado: dois sistemas trocando informação. A API é o meio que costuma permitir isso. Um sistema sem API normalmente é mais difícil de integrar.
Preciso de uma API na minha empresa?
Só se houver informação sendo digitada em mais de um lugar, ou se você quer que um sistema mostre ou receba dados de outro. Se tudo já está em um só lugar, talvez não precise.
Uma API é segura?
Depende de como foi construída. Pergunte ao fornecedor como o acesso é controlado: quem pode pedir o quê, e como isso é registrado.