Inicio Rápido
Empezá con la Bamwor API en 5 minutos. Registrá tu API key gratis, autenticá con curl, JavaScript o Python, y consultá países y ciudades.
Obtené tu API key
Registrate para una API key gratis enviando un pedido POST:
Registrá tu API key gratis
Te enviaremos un código de verificación a tu email.
Hacé tu primer pedido
Usá tu API key para obtener datos de un país:
curl -H "X-API-Key: bw_live_your_key" \
https://bamwor.com/api/v1/countries/japanTambién podés usar el header Authorization: Bearer en vez de X-API-Key. Los pedidos anónimos (sin key) están limitados a 100/día.
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'])Explorá la API
Probá estos endpoints:
/api/v1/countries?sort=populationPaíses ordenados por población
/api/v1/countries/brazil/cities?sort=populationCiudades de Brasil por población
/api/v1/search?q=tokyo&type=cityBuscar ciudades llamadas Tokyo
/api/v1/rankings/populationRanking mundial de población
/api/v1/cities/3435910/nearby?radius=100Ciudades cerca de Buenos Aires
Solución de problemas
▶Recibo 401 INVALID_API_KEY
Asegurate de enviar la key en el header X-API-Key o como Authorization: Bearer. Las keys empiezan con bw_live_. Si te acabás de registrar, esperá unos segundos e intentá de nuevo.
▶Recibo 429 RATE_LIMIT_EXCEEDED
Superaste el límite de tu plan. El plan gratis permite 30 pedidos/min y 1.000/día. Revisá X-RateLimit-Remaining en los headers de respuesta. Pasate a Pro para más capacidad.
▶La respuesta es lenta
Los primeros pedidos a un endpoint pueden ser más lentos mientras la caché se llena. Las siguientes llamadas usan caché y responden en menos de 50ms. Si persiste, verificá la latencia de tu red a bamwor.com.
▶¿Cómo busco en español o portugués?
El endpoint /search busca automáticamente en los 4 idiomas. Buscá en tu idioma preferido: /api/v1/search?q=Alemania encontrará Germany.