Avvio Rapido
Inizia con la Bamwor API in 5 minuti. Registra la tua API key gratuita, autenticati con curl, JavaScript o Python, e interroga paesi e città.
Ottieni la tua API key
Registrati per una API key gratuita inviando una richiesta POST:
Registra la tua API key gratuita
Ti invieremo un codice di verifica alla tua email.
Fai la tua prima richiesta
Usa la tua API key per ottenere dati di un paese:
curl -H "X-API-Key: bw_live_your_key" \
https://bamwor.com/api/v1/countries/japanPuoi anche usare l'header Authorization: Bearer invece di X-API-Key. Le richieste anonime (senza key) sono limitate a 100/giorno.
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'])Esplora l'API
Prova questi endpoint:
/api/v1/countries?sort=populationPaesi ordinati per popolazione
/api/v1/countries/brazil/cities?sort=populationCittà del Brasile per popolazione
/api/v1/search?q=tokyo&type=cityCerca città chiamate Tokyo
/api/v1/rankings/populationClassifica mondiale di popolazione
/api/v1/cities/3435910/nearby?radius=100Città vicino a Buenos Aires
Risoluzione dei problemi
▶Ricevo 401 INVALID_API_KEY
Assicurati di inviare la key nell'header X-API-Key o come Authorization: Bearer. Le key iniziano con bw_live_. Se ti sei appena registrato, aspetta qualche secondo e riprova.
▶Ricevo 429 RATE_LIMIT_EXCEEDED
Hai superato il limite del tuo piano. Il piano gratuito consente 30 richieste/min e 1.000/giorno. Controlla X-RateLimit-Remaining negli header della risposta. Passa a Pro per limiti superiori.
▶La risposta è lenta
Le prime richieste a un endpoint possono essere più lente mentre la cache si riempie. Le chiamate successive usano la cache e rispondono in meno di 50ms. Se persiste, verifica la latenza della tua rete verso bamwor.com.
▶Come cerco in spagnolo o portoghese?
L'endpoint /search cerca automaticamente in tutte e 4 le lingue. Cerca nella tua lingua preferita: /api/v1/search?q=Germania troverà Germany.