O que é uma API?

✅ O que significa “API”?

A sigla API vem do inglês Application Programming Interface, ou seja, Interface de Programação de Aplicações.

Application → Aplicação (software, sistema, programa)
Programming → Programação
Interface → Meio de comunicação, ponto de contato, contrato

Em termos simples:

API é um conjunto de regras que permite que dois sistemas (softwares) conversem entre si.

✅ Analogia Simples: Restaurante e o Garçom

Imagine um restaurante:

Você → é o cliente (aplicação que quer algo)
A Cozinha → é o sistema que possui os dados ou faz o trabalho (ex.: banco de dados, regras de negócio)
O Garçom → é a API

Como funciona:

Você faz seu pedido ao garçom (Ex.: “Quero um suco de laranja”).
O garçom leva o pedido até a cozinha.
A cozinha prepara o suco.
O garçom traz o suco até você.

→ Você não precisa saber como a cozinha funciona. Só precisa falar com o garçom, seguindo o cardápio (contrato) que diz o que pode ser pedido.

API é o garçom entre quem quer algo (cliente) e quem fornece algo (servidor ou serviço).

✅ O que é uma API em termos técnicos?

Uma API é um conjunto de funções, métodos ou rotas que um software disponibiliza para que outro software consiga interagir com ele.
A API define como fazer os pedidos (requisições) e como os dados vão chegar de volta (respostas).
Funciona como um contrato: diz quais dados você pode enviar, quais dados vai receber e em qual formato (por exemplo JSON, XML).

Exemplo:

Você quer saber a previsão do tempo.
Existe um sistema meteorológico (servidor) que oferece uma API.
Você envia uma requisição HTTP para a API:

GET https://api.tempo.com/v1/previsao?cidade=São Paulo

A API responde com dados estruturados, por exemplo em JSON:

{
"cidade": "São Paulo",
"temperatura": "27°C",
"condicao": "Ensolarado"
}

→ Você não sabe onde o sistema busca essa informação. A única coisa que sabe é como falar com a API.

✅ Principais características de uma API

✔ Interface bem definida

Explica como usar (endpoints, parâmetros, formatos de dados).
É documentada.

✔ Padronização

Usa padrões de comunicação (HTTP, REST, SOAP, GraphQL etc.).
Permite que qualquer linguagem/programa possa consumir a API (JavaScript, Python, Java etc.).

✔ Segurança

Muitas APIs exigem autenticação (token, chave de API, OAuth etc.).

✔ Independência

Você consegue usar a API sem saber como o sistema interno funciona.

✔ Automação e Integração

É o que permite integrar sistemas diferentes.
Ex.: apps no celular conversando com servidores, sites puxando dados de serviços externos etc.

✅ Tipos de API

Há vários tipos, mas os principais são:

🔶 APIs REST

Usam protocolo HTTP.
Baseadas em recursos (users, products, posts…).
Usam métodos como GET, POST, PUT, DELETE.
Ex.:

GET /users/123

🔶 APIs SOAP

Mais antigas.
Baseadas em XML.
Usadas em sistemas corporativos legados.

🔶 APIs GraphQL

Você decide quais dados quer buscar.
Evita overfetch (dados demais) ou underfetch (dados de menos).
Ex.: apenas nome e email de usuários.

🔶 APIs Locais ou Bibliotecas

Não precisam de rede.
Ex.: Biblioteca de um sistema operacional (Windows API), SDKs etc.

✅ Exemplo Prático (API REST)

Imagine uma API de usuários:

GET /users → lista usuários
POST /users → cria usuário
GET /users/5 → detalhes do usuário com ID 5
PUT /users/5 → atualiza dados do usuário 5
DELETE /users/5 → exclui o usuário 5

→ Você envia as requisições usando ferramentas como Postman, Insomnia ou via código (JavaScript, Python etc.).

✅ Benefícios de usar API

Permite integração entre sistemas diferentes.
Facilita a escalabilidade (vários apps podem consumir a mesma API).
Desacopla sistemas (um front-end pode mudar sem mudar o back-end).
Possibilita reuso de funcionalidades.
Abre caminho para parcerias comerciais (ex.: APIs de pagamento, redes sociais, mapas etc.).

✅ Exemplo do dia a dia

Google Maps → oferece API para sites exibirem mapas.
WhatsApp → oferece API para empresas enviarem mensagens automáticas.
MercadoPago → oferece API para integrar pagamentos em sites.
Instagram → oferece API para apps buscarem posts ou stories.

✅ Resumo Simplificado

→ API é uma ponte entre dois sistemas. É como um contrato que define como conversar com outro software.

Sem API:

Os sistemas são ilhas isoladas.

Com API:

Os sistemas podem trabalhar juntos.