Você provavelmente usa APIs várias vezes por dia sem saber. Quando o aplicativo do banco mostra o saldo, quando o Maps calcula uma rota, quando você faz login em um site usando o Google. Em todos esses casos, um sistema está se comunicando com outro por uma API. Mas o que isso significa de verdade?

A analogia do garçom

Imagine um restaurante. Você é o cliente (seu app), a cozinha é o servidor (banco de dados, serviço), e o garçom é a API. Você não entra na cozinha, você faz o pedido para o garçom, ele leva à cozinha, e traz o resultado para você. A API define qual o "cardápio" de pedidos disponíveis e o formato da resposta.

Exemplos do dia a dia

• Quando um app de clima exibe a temperatura, ele usa a API de um serviço meteorológico.

• Quando você faz login com Google numa app, é a API do Google que autentica.

• Quando um e-commerce mostra rastreio dos Correios, usa a API dos Correios.

• ChatGPT pode ser acessado via API, é assim que outros apps integram IA.

• O Pix usa APIs para comunicar bancos diferentes em milissegundos.

Como funciona tecnicamente?

APIs web modernas usam o protocolo HTTP, o mesmo do navegador. Você faz uma requisição para um endereço (endpoint) com um método (GET para buscar dados, POST para enviar, PUT para atualizar, DELETE para apagar) e recebe uma resposta, geralmente em formato JSON.

REST vs GraphQL

REST é o padrão mais comum: cada recurso tem um endpoint (ex: /usuarios, /produtos). GraphQL usa um único endpoint e você especifica exatamente quais dados quer na requisição, mais flexível, mas mais complexo.

Autenticação em APIs

A maioria das APIs exige autenticação para controlar acesso e limitar uso. Os métodos mais comuns são API Keys (uma chave secreta passada no cabeçalho da requisição) e OAuth 2.0 (o protocolo usado pelo "Login com Google/Facebook").

Para testar APIs: o Postman

O Postman é a ferramenta padrão para testar requisições de API sem escrever código. É gratuito, visual e intuitivo, excelente para explorar APIs antes de integrá-las no seu projeto.