Resumen

  • RFC 9745, de marzo de 2025, definió Deprecation como una fecha en la sintaxis Structured Fields. El recurso anunciado puede mantener su comportamiento.
  • El enlace con relación deprecation lleva a la política o a instrucciones de migración y puede aparecer antes de la fecha. RFC 8594, de 2019, reservó Sunset para el momento en que se espera que el recurso deje de responder.
  • La señal se refiere al recurso de la respuesta; ampliar el alcance requiere reglas propias de la API. El operador decide el calendario mientras sus usuarios organizan la transición.

El servicio avisa mientras sigue sirviendo

Una API no tiene que fallar para estar de salida. Puede devolver datos correctos, aceptar solicitudes y superar todos los controles de disponibilidad mientras sus responsables preparan otro producto. Una página de política humana suele quedar lejos de la respuesta que ven los desarrolladores. El primer error real, por su parte, llega demasiado tarde para que una empresa cambie sus clientes, permisos y pruebas con calma.

RFC 9745 llevó el aviso al intercambio HTTP. El campo Deprecation acompaña a la respuesta del recurso afectado y contiene una fecha escrita como valor de Structured Fields. El ejemplo Deprecation: @1688169599 corresponde al 30 de junio de 2023 a las 23:59:59 UTC. Si la fecha queda por delante, la deprecación llegará entonces; si ya pasó, el recurso está deprecado. Ninguno de los casos apaga automáticamente el servidor.

Ahí está la tensión que el protocolo hizo visible. El mismo paquete puede decir «aquí tienes el resultado» y «prepara otra dependencia». La norma indica que el acto de deprecar no cambia el comportamiento del recurso. Para el cliente, la disponibilidad actual deja de ser una excusa suficiente para construir una integración que tendrá que desmontar después. La operación diaria y la planificación de versiones hablan en relojes distintos.

El alcance tampoco se deduce por contagio. La cabecera se refiere al recurso identificado por esa respuesta. Una compañía puede querer aplicarla a un grupo o a toda una API, pero debe definir las reglas que extiendan el aviso. Un desarrollador que observa una sola respuesta dispone de evidencia sobre ese recurso; la amplitud del plan depende de lo que publique el operador.

Instrucciones antes de que empiece la cuenta

RFC 9745 registró además la relación deprecation para el campo Link. El enlace puede abrir documentación sobre sustitutos, fases y política de avisos. Puede aparecer incluso sin la cabecera fechada: en ese caso existe información sobre cómo se gestionará el desuso, mientras el recurso todavía no ha sido declarado deprecado. El operador puede mostrar sus reglas antes de activar el reloj.

La fecha por sí sola no migra una aplicación. Hay que comparar respuestas, trasladar credenciales, adaptar datos y desplegar versiones. Un documento enlazado desde el tráfico vivo puede hacer ese trabajo planificable, siempre que describa un reemplazo real y delimite los recursos afectados. La cabecera distribuye la noticia; el operador sigue controlando la calidad de las instrucciones. El cliente asume el coste de ejecutarlas.

El aviso y el cierre tienen fechas diferentes

RFC 8594 había definido Sunset en mayo de 2019 para señalar cuándo se espera que una URI deje de responder. Usa una fecha HTTP tradicional. Deprecation marca el estado de un recurso que ya no se recomienda como base de dependencias nuevas, aunque continúe activo. Uno informa de una elección de mantenimiento; el otro anticipa una pérdida de disponibilidad.

La especificación de 2025 permite usar ambos y exige que la fecha Sunset no sea anterior a la de Deprecation. Su ejemplo coloca la primera advertencia el 30 de junio de 2023 y el posible cierre un año después. Si el cierre anunciado precediera a la deprecación, el proveedor habría publicado un calendario incoherente. Las cabeceras conservan dos escrituras distintas: el signo @ de Structured Fields en una, la fecha HTTP en la otra.

Estos tiempos expresan lo que el proveedor espera y comunica a sus usuarios. La credibilidad se gana con documentación, alcance preciso y una sustitución que funcione. Faltan respuestas fechadas de servicios concretos para identificar dónde se desplegó la nueva cabecera. El registro normativo ya muestra una herramienta de poder: el recurso que funciona lleva en su propia respuesta la decisión de dejar de ser la opción futura.