➕ Error 510 – No extendido (Not Extended)

El error 510 indica que el servidor requiere que la solicitud del cliente sea extendida mediante ciertas extensiones o parámetros adicionales, pero el cliente no los proporcionó.

Este código pertenece al estándar HTTP Extensions Framework, que permite a los servidores definir extensiones opcionales u obligatorias para ciertas operaciones.

En pocas palabras:
“Tu solicitud necesita información adicional o extensiones especiales, pero no las enviaste.”

✅ Causas más comunes

🧩 1. El servidor exige encabezados de extensión específicos

Por ejemplo:

Autenticaciones avanzadas
Parámetros extra
Mecanismos de negociación
Extensiones HTTP personalizadas

🚫 2. La solicitud no cumple con los requisitos de la extensión

Ejemplos:

Falta un campo requerido
El cliente no envía un header obligatorio
No se cumplen reglas definidas por el servidor

🔧 3. API o servicio que requiere extensiones personalizadas

Servicios avanzados pueden requerir información adicional:

Control de versiones
Metadatos
Reglas empresariales
Seguridad especial

🔐 4. Un sistema usa el framework HTTP Extensions y el cliente no lo conoce

Esto pasa en:

Servicios corporativos
Plataformas internas
Sistemas con reglas avanzadas

🧱 5. El servidor devuelve instrucciones para completar la solicitud

El servidor a veces indica qué extensión falta.

Ejemplo típico:

🔧 Soluciones recomendadas

1️⃣ Revisar la respuesta del servidor para ver qué extensiones requiere

Muchos servidores incluyen:

O bien:

Debes añadirlos a la solicitud.

2️⃣ Agregar los encabezados o parámetros solicitados

Ejemplos:

En cURL:

En Axios:

3️⃣ Consultar la documentación de la API

La mayoría de APIs que devuelven 510 tienen requisitos especiales como:

Versionado de API
Extensiones de seguridad
Tokens de sesión avanzados
Firmas digitales

4️⃣ Implementar la extensión requerida en el cliente

Si es una extensión HTTP, debes:

Enviar headers obligatorios
Cumplir el protocolo definido
Incluir metadatos adicionales

5️⃣ Actualizar el cliente o librería HTTP

Algunas librerías no soportan extensiones modernas.

Instalar o activar soporte adecuado puede resolverlo.

🔐 Consejo Pro

El 510 Not Extended es muy raro y casi siempre indica una integración incompleta entre cliente y servidor.
Para evitarlo:

✔️ Lee la documentación de la API
✔️ Agrega los encabezados o parámetros faltantes
✔️ Cumple la extensión requerida por el servidor
✔️ Asegúrate de usar un cliente actualizado

Si el servidor usa extensiones avanzadas, tu cliente deberá adaptarse a esa lógica.