Cosa significa
Il client deve autenticarsi per accedere alla rete, di solito su un captive portal (Wi-Fi di hotel o aeroporto).
Cause comuni
- Un captive portal Wi-Fi intercetta le richieste
- La sessione di accesso alla rete è scaduta
Come risolvere
Lato client o visitatore
Apri una pagina qualsiasi nel browser e completa l'accesso al Wi-Fi o la pagina dei termini.
Lato gestore del sito o dell’API
I captive portal dovrebbero inviare 511 invece di reindirizzare con 302, così le app non scambiano la pagina del portale per contenuto reale.
Risposta di esempio
HTTP/1.1
HTTP/1.1 511 Network Authentication Required
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: text/html
<html><head><meta http-equiv="refresh" content="0; url=https://login.wifi.example/"></head></html> Specifica
Domande frequenti
› Chi invia il 511?
Il captive portal della rete, non il sito che stavi cercando di raggiungere.
› Perché la mia app riceve HTML invece di JSON sul Wi-Fi dell'hotel?
Il captive portal ha intercettato la richiesta; controlla se c'è un 511 o reindirizzamenti inattesi.