- Introducción
- Importar Archivos a la Aplicación
- Validar Autorización con Tokens
- Modificar Datos para POST y PUT
- Modificar Datos Específicos GET y DELETE
En Payku te ofrecemos una colección en Postman la cual te permite trabajar a través de una extensión en el navegador o como aplicación desde tu sistema, para uso rápido y fácil de nuestra API REST, ideal tanto para desarrolladores como usuarios.
De igual forma proporcionamos un entorno personalizado, que se puede importar cómodamente para aplicar modificaciones y usarlo con sus tokens publicos y privados. Para obtener más información acerca de la documentación Payku puede ingresar a Documentación.
-
Descarga los archivos JSON de las colecciones Payku API. Podrá obtener esos archivos descargando este repositorio.
-
Una vez descargado los archivos, abra la aplicación Postman y diríjase a la pestaña (Workspaces) en la parte superior izquierda.
-
Importe la colección y ambiente a la aplicación Postman haciendo clic izquierdo en el (Import) ubicado en la parte superior izquierda y luego clic en (Upload Files) en la ventana emergente, posteriormente seleccione los archivos descargados.
Una vez realizado el proceso contará con los archivos JSON de la colección en su aplicación los cuales tendrán diferentes folders y request que podrá modificar cómodamente.
-
Una vez contamos con los tokens de integración creados en la plataforma Payku luego de su registro, procedemos a ingresar en el ambiente de la colección.
-
Nos ubicaremos en la parte izquierda de la aplicación haciendo clic izquierdo en (Enviroments), seleccionaremos la carpeta de (Payku API). A continuación reemplacé las variables token_pub y token_priv con los tokens público y privado respectivamente y haremos clic izquierdo en (Save).
Realizado este proceso la aplicación Postman generara automáticamente la autorización en todos los folders y request de la colección.
-
Ya con la autorización registrada ingresamos en cualquier request (POST) ubicados en los folders de la colección. Para acceder hacemos clic izquierdo en (Collections) ubicado en la parte izquierda de la aplicación y luego desplegamos el folder al cual queremos ingresar en el icono ( / ) con clic izquierdo y seleccionamos el request deseado.
-
Una vez seleccionado el (POST) deseado hacemos clic izquierdo en (Pre-request Script) ubicado en la parte central de la aplicación y tendremos acceso al cuerpo modificable. Una vez modificado los datos hacemos clic izquierdo en (Save) y luego en (Send) para transmitir los datos.
Cabe destacar que la estructura del cuerpo en el request debe regirse por los campos preestablecidos como se indica en la Documentación de Payku. En caso de realizar una modificación del cuerpo en los request POST de Suscripción, debe aplicarse el cambio tanto en (Pre-request Script) como en el (Body) tal como muestra el ejemplo de la imagen. Esto para que la firma de autorización coincida.
- En este proceso ingresaremos en un request (GET) de obtención específica o (DELETE), luego cambiamos el (Código ID) valido para la solicitud que se desea obtener según el request seleccionado.
- Copie el (ID) valido de la solicitud requerida y luego se pegara en la barra url a partir del ( / ) como se muestra en el ejemplo 1 y 2. Finalmente haremos clic izquierdo en (Save) y posteriormente en (Send).
Para mayor información sobre la aplicación Postman también puede acceder a su documentación ingresando en Doc Postman.