- Software y sistemas
- Servicio HTTP
428
HTTP 428 Precondition Required: falta la condición exigida
Nivel de riesgo
Seguro
Puedes actuar sin peligro siguiendo las comprobaciones seguras.
Urgencia
Media — atiéndelo hoy
Respuesta rápida
HTTP 428 significa que el servidor exige que la petición sea condicional, normalmente para no pisar cambios de otra persona. Recarga el recurso para trabajar sobre su versión actual y pide al desarrollador que envíe la condición, por ejemplo If-Match.
Seguridad primero
Antes de continuar
- No pegues tu versión encima sin recargar para quitarte el aviso de en medio: el 428 está para que no borres cambios que otra persona hizo en el mismo recurso.
Puedes hacerlo con seguridad
- Recarga del recurso antes de guardar
- Explicación incluida en la respuesta 428
- Cabecera condicional en la petición de cambio
Deja estas tareas a un profesional cualificado
- No intentes esta tarea profesional: Peticiones condicionales en el cliente
- No intentes esta tarea profesional: Respuesta explicativa y sin caché en el servidor
Lo que un técnico debe poder justificar
Viene un técnico
Estos son los pasos que tiene que hacer y enseñarte. Márcalos mientras trabaja: si se salta pasos, no aceptes el cambio de pieza.
No son instrucciones para que abras o manipules el equipo. Son las comprobaciones que deben sostener una conclusión técnica.
Peticiones condicionales en el cliente
Qué haceEl desarrollador hace que el cliente guarde la versión del recurso al leerlo y envíe las modificaciones con If-Match.
Te tiene que enseñarun cambio aceptado con la condición y otro rechazado cuando la versión ya cambió.
Por escritola modificación del cliente y la versión que la incluye.
Respuesta explicativa y sin caché en el servidor
Qué haceEl responsable de la API comprueba que su 428 explica cómo reenviar la petición y que la respuesta no se guarda en caché.
Te tiene que enseñaruna respuesta 428 de ejemplo con la explicación.
Por escritoel texto añadido y la documentación actualizada.
Antes de aceptar una pieza o reparación
Aún no ha demostrado nada. No aceptes un cambio de pieza solo por el código.
Sigue estos pasos
Aviso: Sigue el orden documentado. Un código identifica el sistema afectado, pero por sí solo no demuestra qué pieza está averiada.
Recarga del recurso antes de guardar
- Quién:
- tú, en la aplicación.
- Cómo:
- copia aparte tus cambios, recarga el documento o el registro y vuelve a aplicarlos sobre la versión actual.
- Resultado que importa:
- si el guardado funciona tras recargar.
- Si funciona:
- indica que el cliente necesitaba la versión actual para enviar la condición.
- Si vuelve el 428:
- apunta a un cliente que no envía ninguna condición; avisa al desarrollador.
- Evidencia a conservar:
- hora del intento y captura del aviso.
Evidencia: RFC 6585 - Additional HTTP Status Codes
Explicación incluida en la respuesta 428
- Quién:
- tú o el desarrollador.
- Cómo:
- lee el texto de la respuesta, que según RFC 6585 debería explicar cómo reenviar la petición (el ejemplo del estándar sugiere If-Match).
- Resultado que importa:
- qué condición pide el servidor.
- Si nombra la cabecera:
- confirma qué le falta a la petición.
- Si no explica nada:
- indica que el servidor no sigue la recomendación; pide la documentación a su responsable.
- Evidencia a conservar:
- captura del cuerpo de la respuesta.
Evidencia: RFC 6585 - Additional HTTP Status Codes
Cabecera condicional en la petición de cambio
- Quién:
- el desarrollador, con un cliente HTTP o las herramientas de red.
- Cómo:
- comprueba si la petición de modificación lleva If-Match u otra condición con la versión obtenida al leer el recurso.
- Resultado que importa:
- presencia y valor de la condición.
- Si falta:
- confirma la causa; añade la condición con la versión actual del recurso.
- Si está presente:
- descarta esta causa y revisa con el responsable del servidor qué condición espera.
- Evidencia a conservar:
- petición y respuesta guardadas sin credenciales.
Evidencia: RFC 6585 - Additional HTTP Status Codes
Situación no resuelta
Si el error persiste, no sigas probando por tu cuenta. Mira qué tiene que hacer y enseñarte el técnico.
Dónde se aplica este código
Un código solo tiene significado dentro del producto y la versión correctos.
Ámbito principal
- Sistema
- Software y sistemas
- Marca
- HTTP
- Tipo de producto
- Servicio HTTP
Variantes conocidas del código
- 428 Precondición requerida
- 428 Precondition Required
- 428 Précondition requise
- 428 Precondizione richiesta
- 428 Vorbedingung erforderlich
- HTTP 428
- HTTP status 428
Qué significa
RFC 6585 define 428 (Precondition Required): el servidor de origen requiere que la petición sea condicional. Su uso típico es evitar la actualización perdida: un cliente lee el estado de un recurso, lo modifica y lo devuelve con PUT mientras un tercero ya lo ha cambiado en el servidor. Al exigir condiciones, el servidor se asegura de que el cliente trabaja con la copia correcta. La respuesta debería explicar cómo reenviar la petición y no debe guardarse en caché. No es un fallo del servidor ni de tu conexión.
Advertencias y condiciones de parada
- Seguroadvertencia editorial
No pegues tu versión encima sin recargar para quitarte el aviso de en medio: el 428 está para que no borres cambios que otra persona hizo en el mismo recurso.
Evidencia: RFC 6585 - Additional HTTP Status Codes
Síntomas y causas
Causas probables · en orden
- Modificación enviada sin condiciónFrecuente
La aplicación hace un PUT u otra modificación sin una cabecera condicional como If-Match. Se confirma porque, al añadirla, el servidor acepta el cambio.
Evidencia: RFC 6585 - Additional HTTP Status Codes
- Copia local desactualizadaPosible
Si otra persona cambió el recurso mientras lo editabas, el servidor necesita saber sobre qué versión trabajas; encaja cuando el error aparece al guardar algo que llevabas tiempo editando.
Evidencia: RFC 6585 - Additional HTTP Status Codes
Técnico virtual
¿Sigue apareciendo 428 tras comprobarlo?
Responde unas preguntas para acotar la causa probable y la siguiente acción segura. Es una orientación - nunca sustituye a un profesional.
Fuentes y referencias técnicas
- 1
IANA HTTP Status Code Registry
Internet Assigned Numbers Authority · 2025 · standard
- 2
RFC 6585 - Additional HTTP Status Codes
IETF / RFC Editor · 2012 · standard
¿Te ha resultado útil esta ficha?