Salta al contenuto
Documentazione · Novità
Documentazione /

Novità

Le novità della REST API e del server MCP di FlyItalyADSB, in ordine di data, dalla più recente: endpoint, strumenti, limiti e correzioni.

Aggiornato il

DataNovità
08/11/2026Le funzioni in più seguono il piano. Il Free comprende posizioni in tempo reale, ricerche e liste, storico voli e tracce degli ultimi 7 giorni, uso commerciale e server MCP. Sorvoli, emergenze e aerei particolari, pista in uso e avvisi su un’area partono da Starter; le tracce vanno indietro 30 giorni con Starter, 90 con Pro, dal 2022 con Fleet. Nuovi codici d’errore plan-feature, tracks-depth, events-depth (403) e area-webhook-limit (409), qui. Valgono subito per le chiavi create da oggi; per quelle già esistenti dal giorno indicato nell’email di avviso.
08/11/2026Il piano Business non c’è più: i piani self-service sono Free, Starter, Pro e Fleet. Per più di 25 aerei sorvegliati, più volume, uno SLA o per rivendere i dati come API o feed, scrivici.
08/11/2026Server MCP, con Fleet: watched_aircraft (elenca, aggiunge o toglie gli aerei sorvegliati dalla chat) e fleet_status (i voli di oggi di ogni aereo sorvegliato, con l’ultimo aeroporto e l’arrivo stimato se è in volo); observed_flights restituisce anche i voli di oggi. Server MCP.
07/11/2026Il piano Fleet, 149 € al mese + IVA: i limiti del Pro (300 richieste al minuto, 10 milioni al mese, il mondo intero), 90 giorni di voli osservati, fino a 25 aerei sorvegliati con i webhook di decollo e atterraggio, e i voli di oggi con l’orario di arrivo stimato. Business (249 €) è Fleet con 250 aerei, 1.000 richieste al minuto, 50 milioni al mese e 12 mesi di voli osservati. Piani.
07/11/2026I tuoi aerei, con Fleet e Business: /v2/watch (gli aerei sorvegliati dell’account, per indirizzo ICAO, immatricolazione o nominativo) e i webhook con kinds: ["takeoff", "landing"], che mandano flight.takeoff, flight.landing e flight.landing_retracted man mano che la rete li rileva. /v2/flights/icao, /reg e /callsign hanno anche today, i voli di oggi con l’orario di arrivo stimato. I tuoi aerei, voli di oggi.
07/11/2026Opzioni delle liste su /v2: ?fields= (solo i campi che chiedi; fields=light per mappe e display), ?with=route (la tratta più frequente di ogni aereo nei voli osservati), /v2/box/{lat_sud}/{lat_nord}/{lon_ovest}/{lon_est} (gli aerei in un riquadro, anche a cavallo del meridiano 180°), fino a 50 aerei in una richiesta contata una volta (/v2/icao/a,b,c, e lo stesso su /hex, /reg, /callsign), ?since= su /v2/history/{icao}/{data} (solo i punti dopo un istante). Opzioni delle liste.
07/11/2026Pista in uso: /v2/airport/{code}/runways, la pista che un aeroporto usa adesso, stimata dagli aerei vicini. Pista in uso.
07/11/2026Voli osservati: trova il tuo volo per tratta (/v2/flights/route/{from}/{to}?around=HH:MM), il registro dei voli di un aereo in CSV (?format=csv), e quanto indietro va ogni piano: Free 7 giorni, Starter 14, Pro 30, Business 12 mesi; oltre, un 403 con code flights-depth, non contato. Voli osservati.
06/11/2026Quando chiedi la chiave: due domande in più, per chi sono i dati (audience) e se usi già un’altra fonte di dati di volo (other_source), e, se ti ha portato qui un assistente AI, cosa gli avevi chiesto (ai_prompt, facoltativo). Obbligatorie nel modulo; in POST /v2/keys accettate già adesso e presto obbligatorie. Autenticazione.
06/11/2026Voli osservati: /v2/flights/callsign/{callsign} (i voli e le rotte abituali di un nominativo), /v2/flights/icao/{hex} e /v2/flights/reg/{reg} (il registro dei voli di un aereo, con un riepilogo per le ore di volo), /v2/flights/airport/{code} (partenze e arrivi di un giorno), costruiti ogni notte dalle tracce della rete, e lo strumento MCP observed_flights. Quando una ricerca live non trova niente, il suo 404 ha last_seen, l’ultimo volo osservato. Voli osservati.
06/11/2026Ricerche più tolleranti: /v2/callsign prova anche il numero di volo (FR5518 trova RYR5518) e i nominativi senza zeri, /v2/reg ignora i trattini, /v2/hex è un alias di /v2/icao, e la nuova /v2/find/{testo} prova nominativo, immatricolazione e indirizzo ICAO. Un 404 dice cosa ha provato e perché. find_aircraft sul server MCP non ha più bisogno di sapere che identificativo ha. Nominativo e numero di volo.
02/11/2026La mappa e l’API si aggiornano ogni mezzo secondo (prima ogni 2–3 secondi), dallo stesso quadro: sulla mappa gli aerei si muovono in modo fluido anche nelle zone più trafficate.
27/10/2026Il formato ADS-B Exchange v2 su https://api.flyitalyadsb.com/api/aircraft/v2: stessi percorsi, header della chiave (api-auth, X-RapidAPI-Key) e JSON dell’API v2 di ADS-B Exchange, più /point e /closest, così il codice scritto per quella cambia solo host e chiave. /v2 non cambia.
26/10/2026/v2/sqk/{squawk} (anche /v2/squawk/) e /v2/type/{type}; le risposte con un elenco hanno anche total. Una tabella delle differenze da ADSBx v2.
27/10/2026In arrivo: entrano in vigore i limiti del piano Free per chiave (fino ad allora valeva solo il limite per IP).
25/10/2026La mappa in chat mostra tutto il traffico dell’area che inquadri, anche quando la sposti, e Live è acceso da subito: un aggiornamento ogni 3 secondi.
22/10/2026Una mappa in chat: su Claude e ChatGPT gli strumenti MCP che restituiscono aerei li mostrano anche su una mappa interattiva.
22/10/2026Traffico notevole: /v2/events (emergenze 7500/7600/7700, militari e altri aerei notevoli per zona, fino a 7 giorni) e lo strumento MCP notable_traffic. Con i piani a pagamento, avvisi via webhook firmati (Avvisi).
22/10/2026Sorvoli: /v2/overflights e lo strumento MCP overflights, gli aerei passati sopra un luogo tra due istanti (dal 17/08/2026).
22/10/2026Profilo di un aereo: /v2/profile/{icao} e lo strumento MCP aircraft_profile.
22/10/2026«Vicino a me» sul server MCP: la posizione salvata sull’account (set_my_location, La mia API), o la città di ChatGPT. Registrazione degli agenti con auth.md. Documentazione e domande frequenti.
21/10/2026OAuth sul server MCP: Claude e gli altri assistenti si collegano con Connetti, senza copiare chiavi.
20/10/2026Vantaggio feeder: i limiti del piano Pro gratis sulle chiavi Free di chi alimenta la rete, per uso non commerciale.
19/10/2026Piani a pagamento self-service: Starter, Pro, Business.
18/10/2026Lo storico copre anche il 2022–2024.
02/09/2026Storico self-service: /v2/history/{icao} e /v2/history/{icao}/{data}.
31/08/2026REST API v2 e server MCP.