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.

1

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.

Já tem uma key? Recupere-a

2

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/japan

Você 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'])
3

Explore a API

Experimente estes endpoints:

🌍
/api/v1/countries?sort=population

Países ordenados por população

🏙️
/api/v1/countries/brazil/cities?sort=population

Cidades do Brasil por população

🔍
/api/v1/search?q=tokyo&type=city

Buscar cidades chamadas Tokyo

📊
/api/v1/rankings/population

Ranking mundial de população

📍
/api/v1/cities/3435910/nearby?radius=100

Cidades 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.