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

1

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.

Hai già una key? Recuperala

2

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

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

Esplora l'API

Prova questi endpoint:

🌍
/api/v1/countries?sort=population

Paesi ordinati per popolazione

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

Città del Brasile per popolazione

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

Cerca città chiamate Tokyo

📊
/api/v1/rankings/population

Classifica mondiale di popolazione

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

Città 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.