Resumo

  • A RFC 9745 usa Deprecation para informar quando um recurso será ou foi descontinuado, e a RFC 8594 usa Sunset para indicar quando seu URI provavelmente deixará de responder; ambos são sinais delimitados, não comprovantes de migração.
  • Um registro de corte deve ligar os cabeçalhos observados ao escopo autorizado, ao destino substituto, aos donos dos clientes, ao uso mensurado, aos testes de compatibilidade, às exceções, às condições de reversão e ao resultado final.

Análise

A retirada de um serviço costuma aparecer primeiro como uma resposta bem-sucedida. O cliente faz a mesma chamada, recebe o mesmo conteúdo e não aciona nenhum alarme. A única novidade é um cabeçalho Deprecation com uma data futura. Para quem opera o servidor, a informação foi publicada. Para quem depende dele, a biblioteca pode ter descartado o campo antes que uma pessoa responsável o visse.

A RFC 9745 padroniza essa comunicação. O valor de Deprecation é uma data em Structured Fields. Uma data futura diz quando o recurso passará a ser considerado descontinuado; uma data passada diz quando essa condição entrou em vigor. O ato de descontinuar não muda o comportamento do recurso. Ele pode continuar respondendo da mesma forma, embora o consumidor já não deva presumir que essa estabilidade permanecerá.

A relação de link deprecation oferece um caminho para mais informações. O provedor pode apontar para política, cronograma, substitutos e orientações de migração. O registro da IANA fixa o significado da relação, mas não valida a página específica. O documento pode omitir diferenças decisivas, ficar desatualizado ou cobrir apenas parte do serviço.

A RFC 8594 aborda a etapa de retirada com Sunset. O campo informa o momento em que se espera que um URI deixe de responder. Ainda assim, é um indício, não uma garantia. O recurso pode falhar antes, continuar depois ou passar a devolver erro ou redirecionamento. O cabeçalho não prevê qual desses resultados ocorrerá. Quando aparece ao lado de Deprecation, a data Sunset não pode ser anterior à data de descontinuação. A ordenação evita um calendário impossível; não demonstra que os clientes estejam prontos.

O escopo não cabe em uma inferência

Em condições normais, cada cabeçalho se aplica ao recurso que o devolveu. Um provedor pode definir que um aviso na página inicial de uma interface cobre todos os recursos de determinada versão. Essa ampliação só é compreendida por quem conhece a regra. Um cliente que chama diretamente um caminho interno talvez nunca veja a página inicial; quem vê o aviso não pode estendê-lo a caminhos que não foram nomeados.

Assim, coletar o campo em um URI produz uma observação precisa, mas estreita. Não prova que todos os métodos, regiões, contas e integrações pertencem à mesma retirada. Da mesma forma, a ausência do campo em um caminho não garante que ele esteja fora de uma decisão comunicada em outro lugar.

As duas RFCs tratam essas informações como opcionais e esperam que clientes funcionem sem elas. Um inventário de consumidores e um mecanismo de notificação continuam necessários. O registro deve preservar o URI exato, o instante, a impressão da resposta, os valores e a autoridade que declarou qualquer escopo maior.

Descobrir o substituto não autoriza a troca

Um link de migração pode ser verdadeiro e útil sem justificar uma mudança automática de produção. A RFC 8594 observa que instruções legíveis por máquina podem executar migrações de identidade em grande escala. Antes de obedecê-las, o consumidor precisa verificar autenticidade, precisão e alcance, para impedir que uma política capture recursos sobre os quais não tem autoridade.

Esse limite aparece em detalhes cotidianos. O novo host pode usar outro emissor de identidade, audiência de token, conjunto de permissões ou limite de chamadas. Um campo retirado pode ter sido opcional para o servidor e obrigatório para a decisão do cliente. A ordem de efeitos e a política de repetição podem mudar. Um redirecionamento adequado para leitura pode invalidar uma escrita assinada. A localização dos dados pode exigir uma aprovação que um teste funcional não fornece.

O padrão não deve certificar essas condições locais. Seu papel é transmitir o estado do ciclo de vida. A organização precisa construir a prova da mudança concreta.

O registro de corte do cliente

O primeiro bloco do registro preserva o sinal: URI canônico, horário e origem da observação, impressão da resposta, valores Deprecation e Sunset e links encontrados. Também informa o escopo declarado e quem tem autoridade para ampliá-lo. Se páginas diferentes descrevem limites incompatíveis, a divergência permanece aberta.

O segundo bloco descreve o destino. Não basta registrar uma URL nova. É preciso comparar formatos, semântica, autenticação, autorização, audiências, limites, ordenação, falhas, retenção e disponibilidade regional. A documentação demonstra o que o provedor comunicou. Um teste com tráfego controlado demonstra o que uma versão específica do cliente experimentou. São provas diferentes.

O terceiro bloco relaciona os consumidores conhecidos. Cada um recebe responsável, criticidade, último uso observado, fonte da medição, estado da migração e próxima decisão. Uma leitura sem tráfego precisa declarar sua cobertura. Cache, intermediário, processo trimestral, ambiente de contingência ou telemetria regional separada podem produzir silêncio enganoso.

O quarto bloco trata exceções. Falta de recurso no substituto, decisão pendente sobre dados ou dependência da atualização de um fornecedor podem justificar espera. A exceção válida tem dono, motivo, mitigação temporária e vencimento. “Ainda usa a versão antiga” descreve o problema, não o governa.

O bloco final autoriza o corte. Ele define clientes pioneiros, medidas de sucesso, condição de parada, alvo e gatilho de reversão e o último instante seguro para voltar. Depois, registra a resposta realmente obtida do recurso antigo. Se o provedor adiar a retirada, a nova decisão não apaga a anterior. Se retirar cedo, a diferença não pode ser escondida pela existência do aviso.

Datas diferentes governam decisões diferentes

Deprecation marca o julgamento sobre a condição do recurso. Sunset expressa expectativa de disponibilidade. O cliente tem sua própria meta, a exceção tem vencimento, a reversão tem limite técnico e o desligamento real só é conhecido após o fato.

Transformar tudo em uma única contagem regressiva retira contexto e autoridade. Pode induzir um desligamento precoce porque “a data chegou”, ou uma demora indefinida porque “ainda funciona”. As datas devem ficar lado a lado, com a pessoa que pode alterá-las, a prova exigida e o efeito da mudança.

Fontes

  1. RFC 9745 — The Deprecation HTTP Response Header Field
  2. RFC 8594 — The Sunset HTTP Header Field
  3. Registro da IANA de tipos de relação de link