API explicada como restaurante
O que é uma API, com um exemplo real de buscar endereço pelo CEP usando fetch.
O que é
API é o garçom: seu site faz um pedido, ela leva até a cozinha (outro sistema) e traz os dados de volta. Clima, frete, pagamento e CEP funcionam assim. Você não precisa saber como a cozinha funciona.
Passo a passo
- Toda API tem um endereço (URL) para onde você manda o pedido.
- No JavaScript, o pedido é feito com
fetch. - A resposta geralmente vem em JSON, um formato de dados com nome e valor.
- Teste o exemplo abaixo no Console (F12) de qualquer página.
- APIs com chave secreta (pagamento, IA) devem ser chamadas pelo servidor, nunca direto do navegador.
Código e comandos prontos
Abrir no navegador (resposta em JSON)
https://viacep.com.br/ws/01001000/json/
Buscar endereço pelo CEP com fetch
async function buscarCep(cep) {
const resposta = await fetch("https://viacep.com.br/ws/" + cep + "/json/");
const dados = await resposta.json();
if (dados.erro) {
console.log("CEP não encontrado");
return;
}
console.log(dados.logradouro, "-", dados.bairro, "-", dados.localidade);
}
buscarCep("01001000");
Prompt pronto para o Claude
Cole no Claude Code, dentro da pasta do seu projeto:
Prompt
Claude, no formulário de entrega do meu site, quando a pessoa digitar o CEP, busca o endereço na API do ViaCEP e preenche rua, bairro e cidade sozinho. Mostra uma mensagem se o CEP não existir. Me explica o que é o fetch e o JSON nesse código.
Erros comuns
- Esquecer o await. Sem ele, você recebe uma "Promise" em vez dos dados.
- Chave secreta no navegador. Qualquer um vê. Chame APIs com chave pelo servidor.
- Não tratar erro. A API pode falhar ou não achar o dado. Sempre mostre uma mensagem.