O que é uma API

API significa Application Programming Interface. É a forma de um sistema conversar com outro sem precisar conhecer os detalhes internos. Pense numa API como o cardápio de um restaurante: você pede pelo cardápio, sem entrar na cozinha.

API como contrato

A API define o que você pode pedir e o que vai receber. Esse acordo é o contrato. Quem chama segue as regras; quem oferece se compromete a respondê-las.

[ Cliente ]  --- pede ---> [ API ]  ---> [ Sistema ]
[ Cliente ]  <-- recebe --- [ API ]  <--- [ Sistema ]

O cliente não sabe (nem precisa saber) como a resposta foi gerada. Só importa o contrato.

Exemplo simples

Você pede a previsão do tempo de uma cidade:

GET /clima?cidade=recife HTTP/1.1
Host: api.exemplo.com

E recebe de volta:

HTTP/1.1 200 OK
Content-Type: application/json

{ "cidade": "Recife", "temperatura": 30, "condicao": "ensolarado" }

Você não programou o serviço de clima. Só usou a API dele.

Por que APIs importam

• Permitem reaproveitar funcionalidades de terceiros (pagamento, mapas, login).
• Separam responsabilidades: cada parte cuida do seu pedaço.
• Deixam sistemas evoluírem por dentro sem quebrar quem os usa, desde que o contrato continue.

Tipos de API (visão geral)

• REST: usa HTTP e recursos. A mais comum na web.
• GraphQL: o cliente pede exatamente os campos que quer.
• gRPC: rápida e binária, boa entre serviços internos.
• SOAP: baseada em XML, mais antiga e formal.
• WebSocket: conexão aberta para comunicação em tempo real.

API interna x pública

• Interna: usada entre partes do seu próprio sistema.
• Pública: aberta para outros desenvolvedores, com documentação e regras de acesso.

O essencial: API é um contrato. Mantenha-o claro, estável e bem documentado, e os sistemas conversam sem dor.