Come funzionano i dati

Due livelli con provenienza diversa, verificati in modo diverso ed etichettati in modo diverso in ogni risposta dell'API.

Livello 1: verdetti sul visto

Il verdetto di base (esenzione dal visto, visto elettronico, visto obbligatorio, …) per ciascuna delle 39.402 coppie passaporto→destinazione proviene da una matrice aggregata dei requisiti di visto: una fonte secondaria, aggiornata all'origine e contrassegnata con la versione del dataset. Non diciamo mai che questi verdetti siano verificati ufficialmente coppia per coppia: le risposte dell'API li etichettano come secondary_source_only.

Livello 2: regole d'ingresso curate

Validità del passaporto, pagine libere, biglietto di proseguimento o di ritorno, febbre gialla, programmi di transito, esenzioni per permesso di soggiorno e portali ufficiali per le domande vengono verificati manualmente per ogni destinazione. Ogni campo compilato cita una fonte governativa ufficiale: {name, url, retrieved_at}. I siti delle agenzie private di visti non vengono mai usati come fonti.

Verifica giornaliera

La verifica si svolge in due fasi, ogni giorno:

• Fase 1: rilevamento automatico delle modifiche. Ogni URL delle fonti citate (~530 pagine ufficiali distinte) viene scaricato ogni notte e ne viene calcolata l'impronta digitale del contenuto. La data last_verified di una destinazione avanza solo quando è dimostrato che tutte le sue pagine citate sono rimaste identiche rispetto all'ultimo controllo. Niente viene aggiornato sulla parola.
• Fase 2: revisione da parte dell'agente. Le pagine il cui contenuto è cambiato, quelle che non rispondono più e un campione a rotazione di tutte le destinazioni vengono rilette integralmente e confrontate con le regole memorizzate. Le modifiche reali aggiornano la regola (citando la stessa autorità); nei casi ambigui viene impostato needs_review; ogni esito è registrato nel feed delle modifiche pubblico.

Le regole più vecchie di 120 giorni sono riportate come stale nei blocchi di verifica di ogni risposta. L'obsolescenza viene dichiarata, non nascosta.

Regole di sicurezza applicate dalla pipeline

• Una regola non viene mai eliminata perché la sua pagina è irraggiungibile. Viene segnalata.
• Il passaggio dall'obbligo di visto all'esenzione dal visto richiede una seconda fonte ufficiale prima di essere applicato.
• Ciò che non si sa viene indicato come sconosciuto. L'API non tira mai a indovinare.
• Ogni commit di dati supera una suite di regressione (58 tratte fissate, invarianti strutturali) e i controlli sulla soglia minima di copertura (nessuna classe di campi può ridursi silenziosamente) prima di poter essere distribuito.

Verifica le affermazioni

Tutto quello che hai letto qui sopra è verificabile: /transparency pubblica copertura, numero di citazioni e grado di aggiornamento calcolati dal dataset servito; /changes.json elenca gli eventi di verifica; /stats.json riporta i contatori in tempo reale; e status.canienter.com interroga l'API ogni minuto. Contatto: api@canienter.com.

Informazioni utili per pianificare il viaggio. Verifica sulle fonti ufficiali prima di partire · Versione del dataset 2026-08-12