Errore 426 Upgrade Required: protocollo non supportato

Il codice 426 richiede un cambio di protocollo. Il campo Upgrade e la documentazione dell’endpoint indicano quale: passare semplicemente da HTTP a HTTPS non è una soluzione universale.

Che cosa significa

Il server rifiuta il protocollo corrente ma indica che potrebbe accettare la richiesta dopo un upgrade.

Come riconoscere il problema

• Risposta HTTP 426.
• Header upgrade.
• API che richiede HTTPS.
• WebSocket non stabilito.
• Client HTTP obsoleto.

Cause più frequenti

• Protocollo non supportato
• Richiesta HTTP invece di HTTPS
• Proxy che rimuove upgrade
• Client senza WebSocket
• Versione HTTP incompatibile
• Endpoint configurato per un protocollo specifico

Diagnosi passo per passo

• Leggi Upgrade nella risposta e confrontalo con i protocolli supportati dal client.
• Verifica URL ed endpoint previsti dal servizio.
• Se è coinvolto un proxy, confronta la configurazione dei due collegamenti con il gestore.

Procedura di risoluzione

• Usa un client e un protocollo compatibili con il servizio.
• Per WebSocket segui la configurazione prevista dal server e dalla versione HTTP utilizzata.
• Le intestazioni Connection e Upgrade del meccanismo HTTP/1.1 non vanno copiate indiscriminatamente in HTTP/2.
• Ripeti la connessione e verifica il protocollo effettivamente negoziato.

Guide Xlogic correlate

• Errore 411 Length Required: cause e soluzioni
• Errore 429 Too Many Requests: cause e soluzioni
• Errore 410 Gone: quando usarlo e come risolverlo

Fonti tecniche

• MDN: HTTP 426