Início Rápido
Comece com a Bamwor API em 5 minutos. Registre sua API key grátis, autentique com curl, JavaScript ou Python, e consulte países e cidades.
Obtenha sua API key
Registre-se para uma API key grátis enviando uma requisição POST:
Registre sua API key grátis
Enviaremos um código de verificação para seu email.
Faça sua primeira requisição
Use sua API key para buscar dados de um país:
curl -H "X-API-Key: bw_live_your_key" \
https://bamwor.com/api/v1/countries/japanVocê também pode usar o header Authorization: Bearer em vez de X-API-Key. Requisições anônimas (sem key) são limitadas a 100/dia.
JavaScript / Node.js
const res = await fetch('https://bamwor.com/api/v1/countries/japan', {
headers: { 'X-API-Key': 'bw_live_your_key' }
});
const { data } = await res.json();
console.log(data.names.en, data.stats.population);Python
import requests
r = requests.get(
'https://bamwor.com/api/v1/countries/japan',
headers={'X-API-Key': 'bw_live_your_key'}
)
data = r.json()['data']
print(data['names']['en'], data['stats']['population'])Explore a API
Experimente estes endpoints:
/api/v1/countries?sort=populationPaíses ordenados por população
/api/v1/countries/brazil/cities?sort=populationCidades do Brasil por população
/api/v1/search?q=tokyo&type=cityBuscar cidades chamadas Tokyo
/api/v1/rankings/populationRanking mundial de população
/api/v1/cities/3435910/nearby?radius=100Cidades perto de Buenos Aires
Solução de problemas
▶Recebo 401 INVALID_API_KEY
Certifique-se de enviar a key no header X-API-Key ou como Authorization: Bearer. As keys começam com bw_live_. Se você acabou de se registrar, espere alguns segundos e tente novamente.
▶Recebo 429 RATE_LIMIT_EXCEEDED
Você excedeu o limite do seu plano. O plano grátis permite 30 requisições/min e 1.000/dia. Verifique X-RateLimit-Remaining nos headers da resposta. Faça upgrade para Pro para limites maiores.
▶A resposta é lenta
As primeiras requisições a um endpoint podem ser mais lentas enquanto o cache aquece. As chamadas seguintes usam cache e retornam em menos de 50ms. Se persistir, verifique a latência da sua rede para bamwor.com.
▶Como busco em espanhol ou português?
O endpoint /search busca automaticamente nos 4 idiomas. Busque no seu idioma preferido: /api/v1/search?q=Alemanha encontrará Germany.