Motimate: ¿Cómo importar la documentación de la API pública de Motimate a Postman?

Introducción

Si eres desarrollador de API, sabes lo importante que es probar y documentar tu aplicación para garantizar su funcionalidad y fiabilidad. Postman es una herramienta popular entre los desarrolladores, ya que proporciona una interfaz fácil de usar para realizar peticiones HTTP, probar puntos finales y visualizar respuestas.

Una de las características clave de esta herramienta es la posibilidad de importar documentación en formato Open API. En este artículo, te guiaremos a través del proceso de importación de la documentación de la API Pública de Motimate (en formato Open API 3.0) a una Colección Postman, haciendo que tus pruebas y desarrollo de la API sean más eficientes.

Requisitos

Antes de empezar, necesitarás tener Postman instalado en tu sistema. Puedes descargarte Cartero aquí.

Importar API Motimate para Colecciones Postman:

1. Ve a la página para descargar la documentación de la API Pública de Motimate(aquí).
    
2. Busca el botón Exportar en la esquina superior derecha y haz clic en él. Selecciona Descargar API y, a continuación, JSON sin resolver.
    
3. Una vez descargado el archivo, abre Postman.
   
   
    
4. Abre la pestaña Colecciones y haz clic en Importar. Sube el archivo descargado como Colección.
   
   
    
5. Es hora de configurar nuestra autorización - haz clic en Motimate Public API y luego selecciona la pestaña Variables.
   
   
    

6. Añade una nueva variable llamada clientId y establece el valor Inicial al valor proporcionado por Motimate. El valor actual se actualizará automáticamente.
   
   entonces...
   
    

   Añade una nueva variable llamada clientSecret y establece el valor Inicial al valor proporcionado por Motimate. El valor actual se actualizará automáticamente.
   
   
   
    

7. Muy importante: ¡Haz clic en Guardar!
   
   
   
    
8. Haz clic de nuevo en Motimate Public API y selecciona la pestaña Autorización.
   
   
    

9. Establece el Tipo a OAuth 2.0. Debería aparecer un formulario. Desplázate hasta la sección Configurar nuevo token.

   Si ves la información "Algunos cambios en el token…", simplemente haz clic en Editar configuración del token.
   
   
   
    

10. Establece el Tipo de concesión como Credenciales de cliente:
    1. Establece la URL del token de acceso en {{baseUrl}}/oauth/token
    2. Establece ID de cliente en {{clientId}}
    3. Establece Secreto de cliente en {{clientSecret}}
       
       
       
        
11. Desplázate hacia abajo y haz clic en Obtener nuevo token de acceso. Postman debería informarte de que la autenticación se ha realizado correctamente. Haz clic en Continuar y luego en Usar Token.
    
     
12. Muy importante: ¡Haz clic en Guardar!
    
     

13. Pulsa: yo → buscar Organización actual → Enviar.

    Deberías ver una respuesta de la API Pública de Motimate, con los datos de tu organización.
    
    
    
     

    ¡Enhorabuena! Ya has importado la API pública de Motimate a Postman Collections 🎉