X-Request-Id
Header de respuesta con un identificador único por request; útil para correlacionar logs entre cliente y servidor al pedir soporte.
`X-Request-Id` es un header de respuesta que la API devuelve en cada llamada con un identificador único asignado por el servidor. Es la forma más simple y robusta de correlacionar lo que el cliente ve con lo que el servidor registró internamente. Cuando algo falla — un timeout, un `500`, una validación inesperada — el cliente puede compartir el `X-Request-Id` con soporte y el equipo de Normadata encuentra de inmediato los logs, traces y métricas asociadas a esa request específica. Formato en Normadata: ULID o UUID v4. Ejemplo de respuesta: ``` HTTP/1.1 200 OK X-Request-Id: 01JCKZ8X7HMQVK5R9F2DBN3PWA Content-Type: application/json ``` Recomendaciones: - Loggear el `X-Request-Id` junto a cada respuesta de la API en el cliente (no solo en errores). - Incluirlo en los reportes a soporte — ahorra horas de búsqueda. - Si tu sistema ya genera un trace ID propio, podés enviarlo en el header de request `X-Request-Id`; Normadata lo respeta y lo refleja en la respuesta para mantener la trazabilidad punta a punta. A diferencia de los headers `X-RateLimit-*`, este no afecta el comportamiento del cliente — es puramente observabilidad. Pero es el header que más rápido resuelve tickets de soporte cuando algo se rompe.