O que significa
O cliente precisa se autenticar para ter acesso à rede, normalmente num portal cativo (Wi-Fi de hotel ou aeroporto).
Causas comuns
- Portal cativo do Wi-Fi interceptando requisições
- Sessão de login da rede expirada
Como resolver
Se você é o cliente ou visitante
Abra qualquer página no navegador e conclua o login do Wi-Fi ou a página de termos.
Se você mantém o site ou a API
Portais cativos deveriam enviar 511 em vez de redirecionar com 302, para que os apps não confundam a página do portal com conteúdo real.
Resposta de exemplo
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>Especificação
Perguntas frequentes
› Quem envia o 511?
O portal cativo da rede, não o site que você tentava acessar.
› Por que meu app recebe HTML em vez de JSON no Wi-Fi do hotel?
O portal cativo interceptou a requisição; verifique se há 511 ou redirecionamentos inesperados.