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:

https://soporte.minomina.com/hc/es-419/articles/4408809379860-Credenciales-API-C%C3%B3mo-generarlas-en-minomina-com

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.

LOGIN

Para el Login en minomina.com vamos a utilizar el método POST donde ingresaremos la URL correspondiente al proceso a utilizar

Produccion: https://www.minomina.com/ApiIntegracion/api/security/login
Pruebas QA: https://minomina-qa.cenet.ws/ApiIntegracion/api/security/login

Contamos con las siguientes opciones de configuración

Params

Authorization

Aquí vamos a seleccionar el tipo de autorización, para lo cual vamos a utilizar Bearer Token

Headers

Aquí seleccionaremos en Key la opción Content - Type y en Value la opción application/json

Body

Aquí seleccionaremos la opción Raw y como lenguaje a utilizar JSON, mismo con el cual vamos registrar el comando para logueo, donde vamos a utilizar todo tal cual como en la siguiente imagen teniendo en cuenta que tanto el login como el password tienen que estar encerrados entre comillas (").

Test

Si no deseas registrar el token en Authorization siempre que este se genere, aquí podemos automatizar dicho proceso registrando el siguiente comando en el cuerpo de la opción

Ten en cuenta que este comando lo tendrás que registrar en todos los ítems que estén asociadas a este método de logueo mediante el tipo Bearer Token, para que esto sea efectivo tienes que modificar el campo token con el siguiente comando en Authorization

Login

Una vez registradas las credenciales de acceso, procederemos con el inicio de sesión dando clic en SEND

Si el proceso fue exitoso, el resultado obtenido será 200 OK y generara el respectivo Token para el modulo Authorization

Fecha De Actualización : 26 De Marzo 2024