API - Creación De Colecciones En Postman
Postman es una herramienta que facilita el desarrollo de API al proporcionar un entorno de trabajo para probar, documentar y compartir APIs. Aquí hay una descripción básica de cómo funciona:
Crear solicitudes HTTP: Postman te permite crear diferentes tipos de solicitudes HTTP, como GET, POST, PUT, DELETE, etc. Puedes ingresar la URL del punto final de la API y agregar parámetros, encabezados y cuerpo de la solicitud según sea necesario.
Enviar solicitudes: Una vez que hayas configurado tu solicitud, puedes enviarla al servidor de la API haciendo clic en el botón "Enviar". Postman enviará la solicitud al servidor y mostrará la respuesta recibida.
Probar y depurar: Postman te permite probar y depurar tus solicitudes HTTP. Puedes ver la respuesta del servidor, verificar los encabezados y el cuerpo de la respuesta, y asegurarte de que la API esté devolviendo los datos esperados.
Organizar colecciones: Puedes organizar tus solicitudes en colecciones para mantener tu trabajo ordenado y fácil de encontrar. Esto es útil cuando estás trabajando en proyectos grandes con múltiples puntos finales de API.
Automatización: Postman también ofrece capacidades de automatización a través de su funcionalidad de pruebas. Puedes escribir scripts de prueba utilizando JavaScript para verificar la respuesta de la API y asegurarte de que esté funcionando correctamente. En resumen, Postman es una herramienta poderosa para desarrolladores de API que simplifica el proceso de probar, documentar y compartir APIs. Es ampliamente utilizado en la industria de desarrollo de software y es especialmente útil durante el proceso de desarrollo y prueba de APIs.
Es de tener en cuenta que para realizar este procedimiento es necesario tener habilitadas la configuración API en nuestro portal, para ello puedes seguir el paso a paso presente en el siguiente link:
Teniendo en cuenta lo anterior vamos a proceder con la creación de la colección a utilizar en minomina.com. Crear colecciones en Postman es bastante sencillo. Aquí tienes los pasos básicos para hacerlo:
Inicia sesión en Postman: Abre la aplicación Postman y asegúrate de haber iniciado sesión en tu cuenta. Si aún no tienes una cuenta, puedes crear una de forma gratuita.
Ir al área de Colecciones: En la barra lateral izquierda de la aplicación, haz clic en la pestaña "Colecciones" para ir al área de colecciones.
Crear una nueva colección: Una vez en el área de colecciones, verás un botón grande y naranja que dice "Crear colección". Haz clic en este botón para comenzar a crear tu nueva colección.
Agregar detalles de la colección: Se te pedirá que ingreses detalles sobre tu nueva colección, como su nombre y una descripción opcional. Completa estos campos según sea necesario y haz clic en "Guardar" o "Crear" para crear la colección.
Agregar solicitudes a la colección: Una vez que hayas creado tu colección, puedes empezar a agregar solicitudes a ella. Puedes hacerlo creando nuevas solicitudes directamente en la colección o arrastrando solicitudes existentes desde la lista de solicitudes.
Organizar las solicitudes: Puedes organizar las solicitudes dentro de la colección arrastrándolas y soltándolas en el orden deseado. También puedes crear carpetas dentro de la colección para organizar tus solicitudes de manera más estructurada.
Guardar la colección: Asegúrate de guardar la colección después de realizar cualquier cambio haciendo clic en el botón "Guardar" o "Actualizar" (si ya existía) en la esquina superior derecha de la ventana de la colección.
GET STATUS
Para el esto vamos a utilizar el método POST donde ingresaremos la URL correspondiente al ambiente a utilizar
PRODUCCION
https://www.minomina.com/ApiIntegracion/api/Nomina/EstadoDocumentoNomina
PRUEBAS (QA)
https://minomina-qa.cenet.ws/ApiIntegracion/api/Nomina/EstadoDocumentoNomina
Ingresamos la siguiente configuración
PARAMS
TipoDocumentoEmpleador: NI que corresponde a NIT (Numero De Identificación Tributaria)
NumeroDocumentoEmpleador: El NIT de la empresa
FechaDocumento: Fecha de emisión del documento a consultar
DocumentoID: Huella o TrackID generado por el software que utilice la empresa
AUTHORIZATION
AUHT TYPE: Bearer Token
TOKEN: Ingresar Token de RESPONSE generado al momento de realizar LOGIN, omitiendo las comillas (")
Una vez realizada dicha configuración dar clic en el botón SEND, y en RESPONSE se generara el resultado al que haya lugar según los datos de la huella ingresada en PARAMS