Você já pagou algo com Pix dentro de um aplicativo de loja, viu a previsão do tempo em um site que não é de meteorologia ou entrou em um serviço com a conta do Google. Em todos esses casos, programas diferentes conversaram entre si. A ponte que permite essa conversa se chama API, e entender o conceito abre as portas para criar muita coisa.
O que é uma API
API vem do inglês Application Programming Interface, ou interface de programação de aplicações. Em palavras simples: é um conjunto de regras que define como um programa pode pedir informações ou ações a outro, sem precisar saber como ele funciona por dentro.
A comparação clássica é a de um restaurante. Você (o cliente) não entra na cozinha. Você olha o cardápio, faz o pedido ao garçom e recebe o prato. O garçom é a API: recebe seu pedido em um formato combinado, leva à cozinha (o sistema) e devolve a resposta.
Exemplos do dia a dia
- Previsão do tempo: um aplicativo pergunta a um serviço meteorológico a previsão da sua cidade.
- Consulta de CEP: o formulário de uma loja preenche rua e bairro automaticamente ao digitar o CEP, usando um serviço de consulta.
- Login social: o botão “entrar com o Google” usa a API do Google para confirmar quem você é, sem expor sua senha ao site.
- Pagamentos: o site da loja envia os dados do pedido à API de um meio de pagamento, que processa e responde se foi aprovado.
- Mapas: o app de entregas mostra o trajeto usando uma API de mapas.
- Inteligência artificial: programas enviam textos à API de um modelo de IA e recebem a resposta.
Como uma API da web funciona
A maior parte das APIs que você vai encontrar roda sobre a internet e segue o estilo REST. O processo tem poucos elementos:
- Endpoint: o endereço específico da API para cada tipo de recurso, parecido com um endereço de site.
- Requisição: o pedido enviado ao endpoint.
- Método: o tipo de ação. Os principais são GET (buscar dados), POST (enviar ou criar), PUT ou PATCH (atualizar) e DELETE (apagar).
- Resposta: o que a API devolve, com os dados e um código de status.
Códigos de status
Toda resposta traz um número que resume o resultado:
- 200: deu certo.
- 201: algo foi criado.
- 400: o pedido foi enviado de forma errada.
- 401 e 403: falta autenticação ou você não tem permissão.
- 404: o recurso não foi encontrado.
- 429: você fez pedidos demais em pouco tempo.
- 500: erro no servidor da API.
Saber esses códigos ajuda muito a entender o que deu errado. O guia como ler mensagens de erro e depurar código mostra como investigar.
O que é JSON
A maioria das APIs responde em JSON, um formato de texto leve para organizar dados. Ele agrupa informações em pares de nome e valor, entre chaves, e listas entre colchetes. Por exemplo, os dados de uma pessoa trazem nome, idade e cidade, cada um com seu valor. É fácil para humanos lerem e para programas processarem, e quase toda linguagem sabe converter JSON em estruturas próprias.
Autenticação e segurança
Muitas APIs precisam saber quem está pedindo. Os modos mais comuns:
- Chave de API: um código enviado junto com cada requisição.
- Token: uma credencial temporária obtida depois do login.
- OAuth: o padrão por trás do “entrar com…”, que dá acesso limitado sem entregar a senha.
Cuidados importantes:
Também respeite os limites de uso (rate limit) descritos na documentação e use sempre conexões HTTPS.
Como testar uma API na prática
Para ver uma API funcionando, siga este roteiro:
- Escolha uma API pública simples, como uma de consulta de CEP ou de dados abertos, e leia a documentação oficial: ela diz os endereços, os parâmetros e um exemplo de resposta.
- Teste no navegador: requisições GET que não exigem chave podem ser abertas digitando o endereço na barra. O navegador mostra o JSON.
- Use uma ferramenta de testes de API: programas como Postman e Insomnia permitem montar requisições e ver as respostas.
- Chame pelo código: em JavaScript, a função fetch busca dados; em Python, existem bibliotecas para isso. Veja o roteiro de JavaScript para iniciantes, que inclui as requisições.
Documentação: sua melhor amiga
Toda API séria tem documentação com a lista de endpoints, exemplos, regras de autenticação e limites. Aprender a ler esse material é uma habilidade central de quem programa. Procure sempre um exemplo pronto, copie, rode e só depois adapte.
Por que isso importa para quem cria sites e apps
Sites e aplicativos modernos raramente fazem tudo sozinhos. Eles combinam serviços por meio de APIs: pagamento, mapa, e-mail, autenticação, banco de dados. E o seu próprio sistema também pode oferecer uma API para que o front-end (a parte visual) busque dados do back-end. Entenda essa divisão em front-end, back-end e full stack. Quem usa assistentes de IA para escrever código também lida o tempo todo com APIs; veja como usar IA para programar.
Próximo passo
Escolha uma API gratuita que combine com um interesse seu (clima, filmes, moedas, CEP), leia a documentação e faça uma consulta pelo navegador ou por uma ferramenta de testes. Quando o JSON aparecer na tela, o conceito vai fazer sentido de vez.