O que são APIs e como usar

A comunicação mais comum na web funciona assim:

Você (ou seu código) faz uma requisição para um endereço. O servidor recebe, processa e devolve uma resposta. Simples assim.

Requisição: GET https://api.exemplo.com/usuarios/42
Resposta:   { "id": 42, "nome": "Maria", "email": "maria@exemplo.com" }

A resposta costuma vir em JSON, um formato de texto que representa dados como pares de chave e valor. Fácil de ler para humanos, fácil de processar por código.

O endereço da requisição é chamado de endpoint. Cada endpoint representa um recurso ou ação específica da API.

Cada requisição usa um método que indica o que você quer fazer:

Na prática:

• GET /usuarios: lista todos os usuários
• GET /usuarios/42: busca o usuário com id 42
• POST /usuarios: cria um novo usuário (dados enviados no corpo da requisição)
• PUT /usuarios/42: atualiza o usuário 42
• DELETE /usuarios/42: remove o usuário 42

Esse padrão é chamado de REST e é o mais usado nas APIs modernas.

Junto com os dados, a API devolve um número que indica se deu certo:

Quando algo não funciona, o status code é o primeiro lugar para olhar.

Postman é a ferramenta padrão para explorar e testar APIs. Você instala, coloca o endereço, escolhe o método, clica em Send e vê a resposta. Sem escrever uma linha de código.

Para testar agora mesmo, use uma API pública gratuita:

• https://jsonplaceholder.typicode.com/users: lista de usuários fictícios para testes
• https://pokeapi.co/api/v2/pokemon/pikachu: dados do Pikachu (PokeAPI)
• https://viacep.com.br/ws/01310100/json/: dados de endereço por CEP (brasileira)

Abra qualquer um desses no navegador e veja o JSON que volta. Isso já é consumir uma API.

JavaScript (navegador ou Node.js):

fetch('https://viacep.com.br/ws/01310100/json/')
  .then(response => response.json())
  .then(data => console.log(data));

// Com async/await (mais legível):
const response = await fetch('https://viacep.com.br/ws/01310100/json/');
const data = await response.json();
console.log(data.logradouro); // "Praça da Sé"

Python:

import requests

response = requests.get('https://viacep.com.br/ws/01310100/json/')
data = response.json()
print(data['logradouro'])  # Praça da Sé

O padrão é sempre o mesmo: faça a requisição, verifique se funcionou, processe o JSON.

Toda API boa tem documentação. Ela lista os endpoints disponíveis, os parâmetros aceitos, o formato da resposta e os erros possíveis.

Quando você abre uma doc de API, procure:

• Base URL: o endereço raiz de todas as requisições
• Authentication: como você se identifica (token, API key, OAuth)
• Endpoints: lista do que dá pra fazer e os parâmetros de cada um
• Exemplos: requisição e resposta lado a lado

A documentação da PokeAPI, do ViaCEP e do JSONPlaceholder são bons exemplos de docs bem escritas para praticar leitura.

APIs públicas gratuitas para construir projetos de portfólio:

• ViaCEP: busca de endereço por CEP. Construa um formulário que preenche o endereço automaticamente.

• OpenWeatherMap (gratuito com cadastro): app de clima por cidade.

• TMDB: dados de filmes e séries. Construa um catálogo com busca.

• GitHub API: liste repositórios de um usuário pelo username.

• Brasil API (brasilapi.com.br): CEP, bancos, CNPJ, feriados, todos dados brasileiros.

• Abri uma API pública no navegador e li o JSON que voltou?

• Fiz uma requisição GET no Postman e entendi a resposta?

• Escrevi código que busca dados de uma API e exibe o resultado?

• Entendo o que significam os status codes mais comuns?

APIs são o que conecta o front com o back, o app com o servidor, um sistema com outro. Saber usar é habilidade que aparece em todas as áreas da tech, não só em desenvolvimento.