Cloudflare cambia le API DNS: cosa devono aggiornare gli sviluppatori entro novembre

26 ottobre 2026. Cloudflare ha annunciato un cambiamento progressivo nelle API con cui si gestiscono gli Advanced Nameservers, i server DNS autorevoli avanzati disponibili nelle configurazioni idonee. La modifica riguarda soprattutto gli sviluppatori di integrazioni e chi automatizza le impostazioni DNS: il nuovo identificatore da usare è nameservers.type: "cloudflare.advanced".

La notizia non segnala un guasto DNS e non richiede, da sola, lo spostamento dei domini. È invece una modifica del contratto API che può diventare importante per script, pannelli interni e applicazioni che assumono un insieme fisso di valori ammessi.

Qual è il cambiamento effettivo

In precedenza, la configurazione degli Advanced Nameservers passava anche dal campo booleano foundation_dns. Cloudflare sta introducendo un valore esplicito nella proprietà nameservers.type, distinguendo la modalità avanzata da quella standard.

Il rilascio è graduale: secondo l'annuncio, parte il 26 ottobre e dovrebbe estendersi nell'arco di sette giorni. Prima che l'aggiornamento raggiunga un determinato account, alcune risposte possono continuare a indicare cloudflare.standard anche in presenza della configurazione avanzata.

Questo dettaglio conta: durante la transizione non bisogna interpretare un singolo campo letto dall'API come prova definitiva di un cambiamento avvenuto nel servizio DNS.

Il problema per i client con valori fissati nel codice

Un'applicazione potrebbe accettare esclusivamente valori noti, ad esempio soltanto cloudflare.standard e custom. Quando riceve cloudflare.advanced, rischia di mostrare un errore di validazione oppure di interpretare in maniera errata la risposta.

Chi mantiene librerie e automazioni dovrebbe quindi controllare i tipi enumerati nel codice, l'elaborazione delle risposte JSON e i test di regressione. Non basta aggiornare una stringa nella documentazione: bisogna verificare che il client sappia leggere e, se autorizzato, scrivere il nuovo valore.

Compatibilità temporanea e fine vita del vecchio parametro

Cloudflare mantiene temporaneamente foundation_dns come alias deprecato. Durante la fase di compatibilità è possibile trovare entrambi i campi e, nelle richieste PATCH che li includono contemporaneamente, i valori devono essere coerenti: l'API rifiuta combinazioni in conflitto.

La pagina ufficiale sulle deprecazioni indica il 23 novembre 2026 come data di inizio della rimozione del parametro precedente, attraverso un ulteriore rollout. Prima di quella scadenza è opportuno pianificare l'aggiornamento dei client che ancora lo usano.

Un controllo utile prima di modificare gli script

1. Individuare i client coinvolti. Cercare l'uso del campo foundation_dns e qualsiasi enumerazione rigida di nameservers.type nel codice, nelle librerie e nelle integrazioni gestionali.
2. Separare lettura e scrittura. Verificare prima che le nuove risposte vengano interpretate correttamente, senza modificare configurazioni di produzione per fare una prova.
3. Controllare la coerenza delle richieste. Se una chiamata invia entrambi i parametri, evitare valori contraddittori; nelle nuove integrazioni preferire il campo indicato dalla documentazione aggiornata.
4. Testare la transizione. Considerare il rollout di più giorni e preparare test per le risposte precedenti e successive, invece di basarsi su un solo account.
5. Rivedere i deploy. Correggere e validare le integrazioni prima di rimuovere l'alias, con possibilità di ripristinare rapidamente versioni precedenti del client.

Che cosa non cambia

Secondo Cloudflare, questa modifica alle API non cambia l'abbonamento Foundation DNS, non attiva automaticamente gli Advanced Nameservers e non richiede migrazioni di zona. Non è una nuova opzione gratuita per tutti: l'uso del valore avanzato nelle operazioni di modifica dipende dai requisiti dell'account.

Per il proprietario di un sito che non gestisce direttamente queste API, l'impatto immediato può essere nullo. Per chi vende software DNS o sviluppa infrastrutture automatizzate, invece, è una modifica da registrare nel ciclo di manutenzione.

Fonti e aggiornamenti

Fonti ufficiali: Cloudflare Changelog, 26 ottobre 2026 e registro Cloudflare delle deprecazioni API. Date e comportamenti descritti fanno riferimento alla documentazione disponibile alla redazione; i rollout possono cambiare.

Redazione Quotidiano Digitale — Sikelia Labs. Articolo originale di servizio per sviluppatori, preparato il 26 ottobre 2026.