Cómo obtener el X-Request-Id de un error usando Postman

Contexto


Cuando un cliente integrado a la API de Clay tiene un error en una llamada, el dato más útil para que el equipo técnico pueda investigar en los logs del servidor es el X-Request-Id, que viene en los headers de la respuesta.


Sin este identificador, encontrar el error específico en los logs del servidor es mucho más lento — a veces imposible si hay muchas peticiones ocurriendo al mismo tiempo.


Diagrama: el mismo ID conecta al cliente con los logs del servidor


Este identificador solo aplica a integraciones vía API (Postman, código propio, etc.). No cubre errores de uso normal de la plataforma web de Clay.



Paso a paso en Postman


  1. Vuelve a enviar la misma petición que te dio el error (mismo endpoint, mismos parámetros) en Postman.
  2. Una vez que llegue la respuesta, ve a la pestaña "Headers".
  3. Busca el header X-Request-Id y copia su valor.


Ejemplo en Postman con el X-Request-Id resaltado

Si al reproducir la petición el error ya no aparece (por ejemplo, si era una condición puntual), igual sirve el X-Request-Id original si guardaste esa respuesta en el historial de Postman — revisa ahí antes de descartar el intento.



Qué enviar a soporte


  • El valor del X-Request-Id.


Ese dato es autosuficiente: no es necesario enviar la hora en que ocurrió el error ni el endpoint llamado, ya que el X-Request-Id por sí solo le permite al equipo técnico ir directo a los logs del servidor y ubicar el error exacto.



Ejercicio práctico


  1. Llamas a GET /v2/obligaciones/dte con tu RUT y un rango de fechas, y recibes un error.
  2. Revisas la pestaña Headers de la respuesta en Postman.
  3. Encuentras: X-Request-Id: a91fd23c-77be-4e91-9b2a-1f8823a0d6f5.
  4. Le envías a soporte solo ese valor.


Con eso, soporte no tiene que pedirte nada más — va directo a revisarlo en los logs.

Actualizado el: 28/08/2026

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!