API
Le API di BusBabel sono riservate agli utenti registrati. Crea una chiave personale in Chiavi API e inviala in ogni richiesta:
curl -H "Authorization: Bearer $BUSBABEL_KEY" "https://busbabel.com/api/v1/devices?category=inverter&trust=IMPORTED"
- Nessun accesso anonimo; nessun export in file: i registri si leggono solo come risposta JSON.
- Ogni chiamata è registrata nella tua pagina Attività (utente, chiave, risorsa, esito).
- Limiti per piano, con header X-RateLimit-* e risposta 429 + Retry-After oltre la soglia.
- Errori nel formato { error: { code, message, details? } }.
Endpoint
- GET /api/v1/devices
- Elenco con filtri (manufacturer, category, protocol, trust, firmware), ricerca q, paginazione next/prev
- GET /api/v1/devices/{produttore}/{modello}
- Dettaglio con versioni, firmware, fonte e registri (version, firmware, include=none, q)
- GET /api/v1/manufacturers
- Produttori
- GET /api/v1/categories
- Categorie
- GET /api/v1/protocols
- Protocolli
- GET /api/v1/me
- Il tuo piano e i tuoi limiti
- POST /api/v1/contributions
- Invio di un contributo (sito, programma desktop, bot)
Specifica completa: OpenAPI 3.1 in docs/api/openapi.yaml nel repository. L'API precedente /api/devices… resta disponibile con le stesse regole di accesso.