Resumen

  • Deprecation comunica cuándo un recurso será o fue declarado obsoleto y Sunset cuándo se espera que deje de responder; las dos fechas son indicios acotados al recurso, no una comprobación de que sus clientes estén listos.
  • Un registro de corte debe unir los encabezados y enlaces observados con el alcance autorizado, el sustituto, los dueños de cada uso, las pruebas de compatibilidad, las excepciones, la reversión y el resultado posterior.

Análisis

La retirada más difícil no comienza con un error. Comienza con una respuesta que aún funciona. Un consumidor llama al recurso conocido, obtiene 200 OK y recibe además Deprecation con una fecha futura. El equipo del servidor puede afirmar con razón que publicó el aviso. El equipo que mantiene el consumidor puede no saber siquiera que su biblioteca descarta encabezados desconocidos.

La RFC 9745 normaliza esa primera pieza. Deprecation es un campo de respuesta cuyo valor es una fecha estructurada. Si la fecha está por venir, señala el momento previsto para que la obsolescencia surta efecto; si ya pasó, indica cuándo ocurrió. La declaración no cambia por sí misma el comportamiento del recurso. Una respuesta satisfactoria puede continuar después de la fecha, aunque el cliente ya no deba suponer que todo seguirá igual.

La misma RFC registra la relación deprecation. Mediante un enlace, el proveedor puede ofrecer documentación adicional antes o después de la fecha. Allí puede explicar una política, un calendario, uno o varios reemplazos y la manera de migrar. La capacidad de enlazar esa información no obliga a que la página resuelva todas esas preguntas. IANA fija el significado interoperable de la relación, no la calidad ni la vigencia del documento concreto.

Sunset, definido por la RFC 8594, comunica otra fase: el instante en que se espera que el URI deje de responder. Tampoco es una garantía. No promete que el recurso llegará vivo hasta entonces, ni que desaparecerá puntualmente, ni anticipa si después habrá redirección, error o silencio. Cuando ambos campos aparecen juntos, la fecha Sunset no puede ser anterior a Deprecation. El orden temporal es necesario, pero no constituye un plan.

El alcance que el encabezado no puede adivinar

La regla normal vincula el dato al recurso que devuelve la respuesta. Un operador puede declarar que un aviso colocado en la portada del servicio cubre todos los recursos de una versión. Sin embargo, esa ampliación solo existe para el consumidor que conoce la convención. Quien nunca consulta la portada no recibe el aviso; quien sí la consulta no puede extenderlo con seguridad a rutas que el proveedor no haya nombrado.

Por eso un recolector de encabezados no equivale a un inventario de dependencias. Puede registrar con precisión el URI visto, la hora y la fecha anunciada. No sabe cuántas aplicaciones comparten credenciales, qué tarea se ejecuta una vez al trimestre o qué tercero encapsula la llamada. Las RFC consideran estos datos opcionales y esperan que los clientes funcionen incluso cuando no aparecen.

También conviene resistir la conclusión inversa. Que un punto final no presente el encabezado no demuestra que esté exento de una retirada anunciada por otro canal. El control debe conservar tanto la observación positiva como los límites de visibilidad.

Un enlace informa; no concede permiso

La documentación de reemplazo puede ser auténtica y aun así resultar insuficiente para una conmutación desatendida. La RFC 8594 advierte que las indicaciones de migración legibles por máquinas pueden efectuar cambios de identidad a gran escala. Antes de actuar hay que validar procedencia, exactitud y alcance, impidiendo que una política afecte recursos que no le pertenecen.

Ese cuidado no es abstracto. El nuevo host puede exigir credenciales diferentes, validar otra audiencia, aplicar cuotas distintas o almacenar datos en otra jurisdicción. Una versión puede eliminar un campo que parecía opcional para el proveedor pero era decisivo para el consumidor. Las reglas de repetición pueden variar y convertir una recuperación inocua en una operación duplicada. Una redirección que sirve para una lectura puede invalidar una firma.

Nada de eso cabe en una fecha. Es materia de contraste entre el contrato anunciado y el comportamiento probado del cliente real.

Un registro de corte verificable

El instrumento mínimo es un registro de corte de migración. Su cabecera conserva el URI canónico, la huella de la respuesta, el momento de observación, los valores Deprecation y Sunset, y los enlaces relacionados. A continuación declara el alcance y cita a la autoridad que puede hacerlo mayor que el recurso observado. Si hay versiones contradictorias, el desacuerdo permanece visible.

El bloque del destino identifica el recurso sustituto y enumera diferencias relevantes: solicitudes, respuestas, autenticación, autorización, audiencia, cuotas, orden de efectos, errores, conservación y cobertura regional. Una prueba controlada debe vincular su resultado a una versión del cliente y a un conjunto de datos. “Compatible” sin condiciones es demasiado amplio para ser evidencia.

El bloque de consumidores asigna cada dependencia conocida a una persona o equipo, con criticidad, última actividad, fuente de medición, estado y próxima fecha de decisión. Los datos de uso requieren una nota de cobertura. Un registro de pasarela puede omitir cachés, intermediarios, redes separadas o procesos de baja frecuencia. Cero llamadas observadas no equivale a cero llamadas posibles.

Otro bloque registra excepciones. Puede faltar una función del sustituto, estar pendiente una aprobación sobre datos o dependerse del lanzamiento de un proveedor. La excepción debe tener dueño, fundamento, protección temporal y caducidad. Si no hay quien pueda renovarla o cerrarla, solo es deuda sin gobierno.

Finalmente llega la autorización del corte: población de prueba, medidas de éxito, condición de detención, destino de reversión y último momento seguro para volver. El registro anticipa el comportamiento esperado del recurso antiguo y anota lo observado después. Si la fecha cambia, se conserva el cambio y su autor; no se reescribe el pasado para que el cronograma parezca estable.

No existe un único reloj

Deprecation fecha un cambio de estatus. Sunset expresa una expectativa de disponibilidad. Cada cliente tiene su propia meta. Cada excepción tiene vencimiento. La reversión tiene un límite técnico. La desconexión real tiene una hora que solo puede conocerse después.

Una cuenta regresiva única convierte esas decisiones distintas en obediencia a la fecha del proveedor. Puede llevar a retirar demasiado pronto porque “el encabezado lo decía”, o a no decidir nunca porque el servicio todavía responde. Mantener los relojes separados permite preguntar quién controla cada uno y qué prueba justificaría moverlo.

Fuentes

  1. RFC 9745 — The Deprecation HTTP Response Header Field
  2. RFC 8594 — The Sunset HTTP Header Field
  3. Registro IANA de tipos de relación de enlace