Códigos de Estado HTTP

401 Unauthorized significa que se requiere autenticación: el servidor no sabe quién eres. Suele ir acompañado de una cabecera WWW-Authenticate que te pide que inicies sesión. 403 Forbidden significa que el servidor sabe quién eres (o la autenticación no es el problema) pero no tienes permiso. Piensa en 401 como «muéstrame tu identificación» y en 403 como «veo tu identificación, pero no estás en la lista».

Un 502 aparece cuando un proxy, balanceador de carga o CDN recibe una respuesta no válida del servidor de origen al que contactó en tu nombre. Causas habituales: el servidor de origen se ha caído, está sobrecargado, se reinició a mitad de la solicitud o devolvió cabeceras HTTP malformadas. El proxy en sí está bien; lo que falla es aquello con lo que el proxy habla. Revisa los registros de tu servidor de aplicaciones y reinícialo si es necesario.

301 Moved Permanently indica a los navegadores y motores de búsqueda que el recurso se ha movido para siempre: deben actualizar sus marcadores y transferir la autoridad de enlace. 302 Found es temporal: los clientes deben seguir usando la URL original. Para el SEO, usa siempre 301 para cambios permanentes de URL. Usar 302 por error en un movimiento permanente puede dividir tus señales de posicionamiento y provocar una propagación lenta.

418 es una broma del Día de los Inocentes del RFC 2324 (1998) — el Protocolo de Control de Cafeteras de Hipertexto. La premisa: un servidor que en realidad es una tetera debería negarse a preparar café con este código. Fue un RFC satírico de Larry Masinter. A pesar de no ser un error real nunca, sobrevivió en el registro de la IANA y se convirtió en una tradición muy querida en el desarrollo web. Algunos servidores lo usan para rechazar humorísticamente bots o automatizaciones no deseadas.

429 significa que has superado un límite de frecuencia: estás enviando demasiadas solicitudes en muy poco tiempo. Cómo solucionarlo como cliente: espera y reintenta tras el tiempo indicado en la cabecera Retry-After, implementa retrasos exponenciales y almacena respuestas en caché cuando sea posible. Como servidor: incluye siempre una cabecera Retry-After; usa algoritmos de ventana deslizante o de depósito de tokens para una limitación justa.

Usa 404 Not Found cuando el recurso no existe pero podría existir en el futuro (o no sabes si alguna vez existió). Usa 410 Gone cuando sabes que el recurso existió previamente y ha sido eliminado de forma permanente sin reemplazo. Para el SEO, 410 indica a los motores de búsqueda que eliminen la URL de su índice más rápido que un 404.