Guia grátis · API

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

  1. Toda API tem um endereço (URL) para onde você manda o pedido.
  2. No JavaScript, o pedido é feito com fetch.
  3. A resposta geralmente vem em JSON, um formato de dados com nome e valor.
  4. Teste o exemplo abaixo no Console (F12) de qualquer página.
  5. 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

Ver todos os guias