Documentazione API
Documentazione della REST API e del server MCP di FlyItalyADSB: guida rapida, autenticazione, endpoint, campi, limiti ed errori, storico, uso commerciale.
Tutto quello che serve per usare l'API e il server MCP. Se hai una domanda veloce, guarda prima le domande frequenti.
Guida rapida Dalla chiave gratuita alla prima risposta dell'API FlyItalyADSB in due minuti, con curl, Python e JavaScript. Autenticazione Chiave in X-Api-Key, OAuth per gli assistenti AI e registrazione degli agenti con auth.md: come ottenere e gestire l'accesso all'API FlyItalyADSB. Endpoint Tutti gli endpoint della REST API v2: un aereo per hex, nominativo o immatricolazione (anche con il numero di volo, fino a 50 in una richiesta), aerei in un raggio o in un riquadro, per squawk o tipo, militari, PIA, LADD, tracce, profilo, sorvoli, storico voli e voli di oggi, aerei seguiti, pista in uso; opzioni delle liste; differenze da ADSBx v2. Compatibilità ADS-B Exchange v2 Usa FlyItalyADSB al posto dell'API v2 di ADS-B Exchange: stessi percorsi, stessi header della chiave, stesso JSON (ac, msg, now, total, ctime, ptime). Cambi host e chiave, nient'altro. Campi e unità I campi di un aereo nell'API (aircraft.json di readsb) e le unità: quota in piedi o "ground", velocità in nodi, dbFlags, seen_pos, fonte della posizione. Limiti ed errori Limiti dell'API per piano (al minuto, al mese, raggio, quanto indietro va lo storico voli), come si contano, gli header X-FIA-* e cosa fare con 400, 401, 403, 404, 429 e i blocchi Cloudflare. Tracce e sorvoli Le tracce ADS-B via API: le date con una traccia di un aereo, la traccia di un giorno, i sorvoli (gli aerei passati sopra un luogo), la copertura dal 2022 e cosa manca. Avvisi, emergenze e i tuoi aerei Emergenze e aerei particolari con /v2/events (squawk di emergenza, militari e aerei rari per zona), i decolli e gli atterraggi dei tuoi aerei (Fleet) e gli avvisi via webhook firmati, con verifica in Python e JavaScript. Server MCP Il server MCP su flyitalyadsb.com/mcp: gli strumenti, «vicino a me», come collegarlo a Claude, Claude Code e altri client, come si contano le richieste. Uso commerciale L'API FlyItalyADSB in app e dispositivi che vendi: una chiave per prodotto, cache sul server, il piano giusto, attribuzione CC BY-SA 4.0, quando scriverci. Novità Le novità della REST API e del server MCP di FlyItalyADSB, in ordine di data, dalla più recente: endpoint, strumenti, limiti e correzioni.