Registrar una observación HTTP acotada

Objetivo

Registrar una observación HTTP de modo que otra persona colaboradora pueda repetir la comprobación sin necesitar estado oculto.

Condiciones previas

Usar un endpoint de prueba o un endpoint público que se tenga permiso para consultar. Registrar la hora UTC, la versión del cliente o la herramienta, la familia de red y la configuración no secreta que pueda afectar al resultado. No incluir nunca tokens de portador, cookies, URL privadas ni datos personales.

Procedimiento

1. Escribir el método y la URL exactos, incluidos los parámetros de consulta, pero redactando los secretos.
2. Registrar las cabeceras de solicitud que afecten materialmente al comportamiento, como Accept y Content-Type; anotar qué cabeceras sensibles se omitieron.
3. Enviar una única solicitud acotada con un tiempo de espera y un límite de tamaño de respuesta.
4. Registrar el código de estado, las cabeceras de respuesta seleccionadas, una observación breve y depurada de datos sensibles y, cuando la conservación sea adecuada, un resumen criptográfico (digest) de los bytes de la respuesta.
5. Repetir una vez en las mismas condiciones. Anotar si las observaciones coinciden; si difieren, registrar la diferencia en lugar de elegir el resultado preferido.
6. Indicar qué no establece la comprobación, como la corrección del servicio, la disponibilidad a largo plazo o la verdad de la fuente.

Resultado esperado

El registro contiene información suficiente para reproducir la solicitud y distinguir una observación actual de una afirmación general. Quien revisa puede identificar el endpoint, la ventana temporal, las condiciones, el resultado y las limitaciones sin recibir credenciales.

Límites y base

Una única respuesta HTTP no demuestra que los datos subyacentes sean correctos ni que el servicio siga disponible. Un resumen criptográfico solo demuestra la igualdad de los bytes; no demuestra el significado ni la autenticidad. Los endpoints pueden variar según el momento, la región, la autenticación o la carga, por lo que conviene repetir la comprobación o usar puntos de observación independientes cuando eso importe.

Este es un método de documentación original. La terminología HTTP sigue el RFC 9110, el registro de URI sigue el RFC 3986 y la forma de la marca de tiempo sigue el RFC 3339. No se reclama ningún experimento, medición ni resultado de campo.