10 de jul. de 2026 · Kevin BK

5 APIs públicas para testar no navegador sem chave

Consulta pública do ViaCEP com endereço retornado na página do DexBase — Uma consulta GET pública pode ser testada com um valor conhecido e lida no próprio navegador antes de qualquer integração.

O que a barra do navegador consegue testar?

Ao colar uma URL e pressionar Enter, o navegador faz uma requisição GET. Esse método serve para ler ou pesquisar um recurso. Se o endpoint for público e os parâmetros estiverem corretos, a resposta pode aparecer como texto JSON na própria aba.

Esse teste confirma três pontos úteis: o endereço responde, o formato é legível e os parâmetros alteram o resultado. Ele não substitui um cliente REST quando a operação exige outro método, cabeçalhos personalizados, corpo de dados ou autenticação.

Funciona bem: endpoints GET sem chave, com parâmetros no caminho ou depois de ?.
Não cabe na barra: POST, PUT, PATCH e DELETE com corpo JSON.
Não exponha: token, senha, documento pessoal ou credencial na URL.

Se os termos endpoint, método e parâmetro ainda forem novos, o guia o que é API e como usar explica a sequência completa de requisição e resposta antes dos testes abaixo.

Comparação rápida das cinco APIs

Serviço	O que retorna	O que alterar	Autenticação
ViaCEP	Endereço de um CEP brasileiro	Oito dígitos no caminho	Sem chave
Open-Meteo	Condições meteorológicas por coordenada	Latitude, longitude, variáveis e fuso	Sem chave no endpoint usado
Banco Mundial	Metadados de um país	Código de duas letras	Sem chave
Open Library	Obras encontradas por título	Título, limite e campos	Sem chave
JSONPlaceholder	Registros fictícios para treinamento	Recurso e identificador	Sem chave

A lista é curta de propósito. Uma coleção com dezenas de nomes perde utilidade quando mistura versões encerradas, planos gratuitos e endpoints que pedem cadastro. Aqui, cada exemplo foi aberto e conferido antes da publicação.

1. ViaCEP: consultar um endereço brasileiro

O ViaCEP recebe oito dígitos no caminho e devolve os campos disponíveis para aquele CEP. Abra a consulta da Praça da Sé, em São Paulo:

Abrir o CEP 01001-000 no ViaCEP

A URL tem o domínio viacep.com.br, o caminho /ws/, o CEP 01001000 e o formato /json/. A resposta inclui campos como cep, logradouro, bairro, localidade e uf.

{
  "cep": "01001-000",
  "logradouro": "Praça da Sé",
  "bairro": "Sé",
  "localidade": "São Paulo",
  "uf": "SP"
}

Para fazer um segundo teste, troque somente os oito dígitos. O ViaCEP informa que um formato inválido, como nove dígitos ou letras, produz erro HTTP 400. Um CEP com formato válido, mas inexistente, devolve JSON com erro igual a true. Isso permite observar a diferença entre pedido malformado e registro não encontrado.

2. Open-Meteo: observar dados que mudam

O endpoint de previsão da Open-Meteo aceita latitude, longitude, variáveis meteorológicas e fuso horário. Este exemplo consulta condições atuais próximas de São Paulo:

Abrir as condições atuais de São Paulo na Open-Meteo

Depois do ponto de interrogação, os parâmetros são separados por &. latitude e longitude definem a posição; current escolhe temperatura e código meteorológico; timezone pede horários no fuso de São Paulo.

A resposta possui blocos como current_units e current. Leia a unidade antes do valor: a API pode informar °C para temperature_2m, enquanto weather_code usa códigos de interpretação meteorológica. O número da temperatura muda com o horário e a atualização dos modelos, portanto não trate uma captura antiga como valor atual.

Para comparar cidades, altere as coordenadas. Se você escrever o nome de uma variável incorretamente, a documentação prevê resposta JSON de erro com status 400 e uma razão. É um bom exemplo para aprender a conferir nomes exatos de parâmetros.

3. API do Banco Mundial: entender resposta com metadados

A API de países do Banco Mundial aceita um código e pode devolver JSON quando recebe format=json. O código de duas letras do Brasil é BR:

Abrir os metadados do Brasil no Banco Mundial

Essa resposta é interessante porque o primeiro item descreve a consulta, com página e total de registros. O segundo item contém uma lista; dentro dela aparece o país com campos como id, iso2Code, name, region, capitalCity, longitude e latitude.

Não procure capitalCity diretamente no primeiro nível. O caminho visual é: lista principal, segunda posição, lista de países, primeiro país. Essa camada de metadados é comum em serviços que oferecem paginação.

Troque BR por JP para consultar o Japão ou por outro código ISO de duas letras. Altere uma coisa por vez e compare name, region e capitalCity.

4. Open Library: pesquisar livros e limitar campos

A Search API da Open Library recebe termos de busca e devolve obras encontradas. Este exemplo procura “Dom Casmurro”, limita a três resultados e pede apenas quatro campos:

Pesquisar Dom Casmurro na Open Library

O espaço entre as palavras aparece como %20, uma codificação própria para URLs. limit=3 evita uma resposta enorme. fields reduz cada item a título, autor, primeiro ano de publicação e identificador.

No JSON, numFound mostra quantos registros corresponderam à busca e docs contém os resultados devolvidos. author_name é uma lista porque uma obra pode ter mais de um autor associado. A própria documentação observa que o esquema completo pode mudar; campos comuns são mais seguros do que depender de todos os detalhes retornados.

Pesquisas bibliográficas também podem trazer edições, grafias e datas diferentes. O primeiro resultado não deve ser tratado automaticamente como a única edição correta. Troque o valor de title e mantenha o limite baixo para observar a ordenação.

5. JSONPlaceholder: praticar com dados fictícios

JSONPlaceholder simula recursos de uma aplicação e foi criado para testes e protótipos. O endpoint abaixo devolve a tarefa de identificador 1:

Abrir a tarefa 1 no JSONPlaceholder

{
  "userId": 1,
  "id": 1,
  "title": "delectus aut autem",
  "completed": false
}

Troque o último número por 2 e compare id, title e completed. Depois, remova o identificador e abra /todos para perceber a diferença entre um objeto e uma lista de objetos.

Esses dados são fictícios. Eles servem para treinar leitura, filtros e interfaces, não para informar tarefas reais. O serviço também simula operações de escrita, mas informa que alterações não são persistidas de verdade. Como a barra de endereços envia GET, os exemplos deste artigo ficam apenas na leitura.

Como ler e alterar uma URL de API

Uma URL de consulta costuma combinar quatro partes:

Domínio: identifica o serviço, como openlibrary.org.
Caminho: escolhe o recurso, como /search.json.
Parâmetros: começam depois de ? e usam o formato nome=valor.
Separadores: & liga um parâmetro ao seguinte.

Não altere domínio, caminho e parâmetros ao mesmo tempo. Faça a primeira URL funcionar, mude um valor e recarregue. Assim, quando o resultado mudar ou falhar, você sabe qual parte causou o efeito.

Caracteres como espaço, acento e barra podem precisar de codificação. No exemplo da Open Library, o espaço virou %20. Copiar texto cru para dentro da URL pode mudar a interpretação do servidor.

Como reconhecer a estrutura do JSON

Objeto: começa com { e reúne pares de chave e valor.
Lista: começa com [ e mantém vários itens em ordem.
Texto: aparece entre aspas.
Número e booleano: aparecem sem aspas; true e false são valores lógicos.
Valor ausente: pode aparecer como null, campo vazio ou chave que não veio.

Comece pela pergunta que você quer responder. Para saber a cidade no ViaCEP, procure localidade. Para contar resultados da Open Library, observe numFound. Tentar entender todos os campos antes de localizar o necessário torna uma resposta grande mais difícil do que ela realmente é.

Uma sequência de teste que evita confusão

Abra exatamente a URL validada.
Confirme que apareceu JSON, não uma página de erro.
Localize dois ou três campos esperados.
Altere somente um parâmetro ou identificador.
Compare a estrutura anterior com a nova resposta.
Teste um valor inválido e leia a mensagem sem repetir requisições rapidamente.
Abra a documentação antes de usar o serviço em um projeto.

Uma resposta 200 prova que aquela requisição foi atendida naquele momento. Não prova que o serviço seja ilimitado, que os dados estejam completos ou que o contrato nunca mudará.

Erros comuns: 400, 404, 429 e CORS

400 Bad Request: parâmetro, formato ou valor não foi aceito. Confira a grafia e as regras da documentação.
404 Not Found: caminho ou recurso não existe. Verifique se o identificador faz parte do endpoint correto.
429 Too Many Requests: o limite de consultas foi excedido. Pare, aguarde e leia a política do serviço.
Erro de nome de domínio: o endereço não pôde ser resolvido. Não anuncie a API como funcional até confirmar a recuperação.

CORS merece uma distinção: você pode conseguir abrir um endpoint em uma aba e ainda receber bloqueio ao tentar consultá-lo por código executado em outro site. A política CORS controla requisições entre origens feitas por páginas, não a simples navegação até a URL. Por isso, “abriu no navegador” não garante que o mesmo endpoint funcionará diretamente no JavaScript do seu domínio.

Cuidados com segurança e dados que mudam

URLs podem ficar no histórico, em registros do servidor, ferramentas de monitoramento e capturas compartilhadas. Nunca coloque senha, token, documento pessoal ou informação privada em um parâmetro só porque o endpoint abre no navegador.

Também separe exemplo de dado permanente. Temperatura muda; catálogos recebem correções; limites e versões podem ser alterados. Registre a fonte e o momento da consulta quando o resultado sustentar uma decisão. Para produção, trate indisponibilidade, resposta vazia, mudança de campo e limite de uso.

Uma API sem chave não é uma API sem regras. Leia licença, atribuição, finalidade permitida e política de tráfego. Repetir consultas em alta frequência pode prejudicar um serviço gratuito e causar bloqueio.

Qual API escolher para o primeiro projeto?

Formulário de endereço: ViaCEP, validando os oito dígitos e tratando erro: true.
Painel meteorológico: Open-Meteo, exibindo unidade, horário e localização junto do valor.
Seletor de países: Banco Mundial, entendendo a camada de metadados da resposta.
Busca de livros: Open Library, limitando resultados e campos antes de montar a interface.
Treino de lista e detalhe: JSONPlaceholder, porque os registros são fictícios e previsíveis.

O diretório de APIs do DexBase reúne outras fontes por tema. Antes de escolher uma, confirme no mantenedor se o endpoint, a autenticação e os limites continuam iguais aos da ficha.

Perguntas frequentes

É possível testar qualquer API pela barra do navegador?

Não. A barra serve para requisições GET simples. APIs que exigem chave em cabeçalho, corpo JSON, login ou métodos como POST e DELETE precisam de código ou cliente REST adequado.

API pública é sempre gratuita e sem chave?

Não. “Pública” pode significar que desenvolvedores externos têm acesso documentado. O serviço ainda pode exigir cadastro, chave, plano, atribuição ou limite por período.

Por que o navegador mostra texto sem formatação?

JSON é um formato de dados, não uma página desenhada. Alguns navegadores formatam chaves e recuos; outros mostram texto contínuo ou oferecem o arquivo para download. O conteúdo pode estar correto mesmo sem cartões ou cores.

Posso usar essas respostas em um site real?

O teste técnico é só o começo. Leia licença, limites, estabilidade, atribuição e política de uso de cada fonte. Dados fictícios do JSONPlaceholder não devem aparecer como informação real, e valores dinâmicos precisam de atualização e tratamento de falhas.