![[Postman] Pasar la marca de tiempo actual en una solicitud de Postman](https://assets.apidog.com/blog/2024/04/postman-passing-current-timestamp-cover.png)
Al crear nuevos registros de datos o modificar datos existentes en el back-end, pasar la marca de tiempo actual puede ser un componente importante. Afortunadamente, Postman, una herramienta de API, tiene las características necesarias para proporcionar marcas de tiempo en las solicitudes.
Con Apidog, puedes hacer cualquier cosa relacionada con las API, desde la construcción hasta la documentación. Para ver qué otras funcionalidades ofrece Apidog, haz clic en el botón de abajo para comenzar. 👇
Este artículo profundiza en dos métodos efectivos para incorporar la marca de tiempo actual dentro de tus solicitudes de Postman: utilizar la variable de marca de tiempo predefinida y aprovechar el poder de los scripts de pre-solicitud.
¿Qué es Postman?
Para los desarrolladores, Postman se presenta como un kit de herramientas de API popular y confiable. Les permite no solo crear y probar API, sino también documentarlas. Al optimizar todo el proceso de desarrollo de API, Postman hace que el mundo a menudo complejo de las API sea más accesible y comprensible.
¿Qué es una marca de tiempo actual?
Una marca de tiempo actual se refiere a una representación del momento exacto en que ocurre un evento. Hay algunos formatos en los que se pueden expresar las marcas de tiempo:
Marca de tiempo Unix (segundos desde la época)
Este formato representa el número de segundos transcurridos desde un punto específico en el tiempo, generalmente el 1 de enero de 1970, 00:00:00 UTC. Ofrece un formato compacto y legible por máquina para las API.
Formato ISO 8601 (AAAA-MM-DDTHH:mm:ss.sssZ):
Este formato estandarizado expresa la fecha y la hora de una manera legible por humanos y analizable por máquinas. Incluye el año, el mes, el día, la hora, el minuto, el segundo, los milisegundos (opcional) y un indicador de zona horaria (Z para UTC). Este formato facilita una comunicación clara y evita confusiones entre diferentes sistemas.
Importancia de las marcas de tiempo en las API
- Precisión y orden: Establecen el momento exacto en que ocurrió un evento dentro de una interacción de API. Esto ayuda a rastrear la creación de datos o los tiempos de modificación, lo que garantiza una secuenciación precisa y evita confusiones sobre cuándo sucedieron las cosas.
- Frescura de los datos: Las marcas de tiempo pueden indicar qué tan recientes son los datos. Esto es crucial para escenarios en los que está involucrada información en tiempo real o datos con una vida útil limitada. Imagina una API de cotización de acciones: conocer la marca de tiempo ayuda a determinar si la cotización refleja la situación actual del mercado.
- Identificación de errores: Las marcas de tiempo pueden ayudar a solucionar errores. Al comparar las marcas de tiempo en la solicitud y la respuesta, los desarrolladores pueden identificar posibles retrasos o señalar dónde ocurrieron los problemas en el flujo de comunicación.
- Control de versiones y auditoría: Las marcas de tiempo se pueden utilizar para rastrear los cambios de versión de la API o registrar la actividad del usuario. Esto facilita las reversiones a versiones anteriores si es necesario y ayuda a mantener un registro del uso de la API con fines de auditoría.
Guía paso a paso sobre cómo pasar la marca de tiempo actual en la solicitud de API de Postman
Paso 1: crea una cuenta de Postman
Crea una nueva cuenta de Postman (solo si no tienes una) y comienza a descargar la aplicación Postman en tu dispositivo. La aplicación ofrece más funciones que su versión web.
Paso 2: crea una nueva solicitud de API en Postman
Una vez que hayas instalado Postman, crea una nueva solicitud haciendo clic en el botón New en la esquina superior izquierda de la ventana de Postman. Selecciona HTTP Request para crear una nueva solicitud, como se muestra en la imagen de arriba.
Paso 3: introduce el método y los detalles de la API
A continuación, debes incluir los detalles de la solicitud de API que deseas crear. Debe incluir componentes como la URL, los métodos HTTP y los parámetros adicionales que requerirá la API.
Paso 4: abre la sección Pre-Request Script
En tu API completada, busca la sección Pre-request script, como se muestra en la imagen de arriba.
Paso 5: inserta el código necesario para incluir la marca de tiempo
En esta sección vacía debajo de la pestaña Pre-request Script, inserta las siguientes líneas de código para que puedas incluir la marca de tiempo.
var moment = require('moment');
pm.environment.set('currentdate', moment().format(("YYYY-MM-DD HH:MM:SS")));
Para este ejemplo en particular, la marca de tiempo se almacenará en la variable currentdate utilizando el método pm.environment.set.
Paso 6: incluye la variable currentdate como una variable de solicitud
Por último, asegúrate de incluir la variable de marca de tiempo en la API configurando el parámetro de la API. Ahora que cada vez que envíes una solicitud en esta API en particular, deberías poder encontrar la marca de tiempo cuando se envió la solicitud.
Apidog: proporciona los mejores detalles de forma predeterminada
Apidog es una plataforma integral de desarrollo de API que puede ser una excelente alternativa a Postman. Con Apidog, ya no tienes que preocuparte por los detalles más pequeños: Apidog los ha tenido en cuenta a todos, así que echa un vistazo a las secciones a continuación para ver cómo ver estos detalles de la API.
Incluir la marca de tiempo en los encabezados de solicitud en Apidog
Para incluir la marca de tiempo actual en el encabezado de la solicitud de API, sigue estos pasos a continuación.
Para agregar la marca de tiempo actual al encabezado de solicitud de una API, prepara las siguientes líneas de código para pegarlas en un script personalizado en la sección Pre Processors, como se muestra en la imagen de arriba.
var timestamp = new Date().getTime();
pm.environment.set("timestamp", timestamp);
Una vez que hayas inicializado la variable de marca de tiempo, asegúrate de agregar la variable como un parámetro de consulta. Consulta la imagen de arriba como referencia.
Ver la marca de tiempo y más en la solicitud de API de Apidog
Con Apidog, puedes encontrar más que solo la marca de tiempo automatizada, también puedes ver otros detalles más precisos que implican la API, como las cookies y el formato de solicitud sin procesar. Con Apidog, puedes solucionar problemas de tus API con precisión para garantizar que tus API estén listas para la implementación.
También puedes considerar hacer pruebas de carga de API para explorar más a fondo tu API y garantizar que la API sea a prueba de errores.
Conclusión
Incorporar marcas de tiempo en tus solicitudes de Postman desbloquea una variedad de beneficios. Ya sea que necesites un seguimiento preciso de los datos, la verificación de la frescura de la solicitud o la identificación optimizada de errores, las marcas de tiempo te permiten trabajar con las API de manera más efectiva. Al aprovechar la variable predefinida o los scripts de pre-solicitud, puedes integrar sin problemas las marcas de tiempo en tu flujo de trabajo.
Recuerda consultar la documentación de la API para asegurarte de que estás utilizando el formato apropiado para una comunicación y claridad de datos óptimas. Con las marcas de tiempo a tu disposición, puedes mejorar tu experiencia de prueba y desarrollo de API en Postman.
