Motimate: Come importare la documentazione API pubblica di Motimate in Postman?

Introduzione

Se sei uno sviluppatore di API, sai quanto sia importante testare e documentare la tua applicazione per garantirne la funzionalità e l'affidabilità. Postman è uno strumento molto diffuso tra gli sviluppatori perché fornisce un'interfaccia facile da usare per effettuare richieste HTTP, testare endpoint e visualizzare le risposte.

Una delle caratteristiche principali di questo strumento è la possibilità di importare la documentazione in formato Open API. In questo articolo ti guideremo attraverso il processo di importazione della documentazione delle API pubbliche di Motimate (in formato Open API 3.0) in una Postman Collection, rendendo più efficienti i test e lo sviluppo delle API.

Requisiti

Prima di iniziare, è necessario che Postman sia installato sul tuo sistema. Puoi scaricare Postman qui.

Importazione di Motimate API per Postman Collections:

1. Vai alla pagina per scaricare la documentazione dell'API pubblica di Motimate(qui).
    
2. Trova il pulsante Esporta nell'angolo in alto a destra e cliccalo. Seleziona Download API, poi JSON Unresolved.
    
3. Una volta scaricato il file, apri Postman.
   
   
    
4. Apri la scheda Collezioni e clicca su Importa. Carica il file scaricato come Collezione.
   
   
    
5. È ora di impostare l'autorizzazione: clicca su Motimate Public API e seleziona la scheda Variables.
   
   
    

6. Aggiungi una nuova variabile denominata clientId e imposta il valore iniziale sul valore fornito da Motimate. Il valore corrente si aggiornerà automaticamente.
   
   allora...
   
    

   Aggiungi una nuova variabile chiamata clientSecret e imposta il valore Initial sul valore fornito da Motimate. Il valore corrente si aggiornerà automaticamente.
   
   
   
    

7. Molto importante: clicca su Salva!
   
   
   
    
8. Clicca nuovamente su Motimate Public API e seleziona la scheda Autorizzazione.
   
   
    

9. Imposta il tipo su OAuth 2.0. Dovrebbe apparire un modulo. Scorri fino alla sezione Configura nuovo token.

   Se vedi l'informazione "Alcune modifiche al token…", clicca semplicemente su Modifica configurazione token.
   
   
   
    

10. Imposta il tipo di concessione su Credenziali del cliente:
    1. Imposta l'URL del token di accesso a {{baseUrl}}/oauth/token
    2. Imposta l'ID del cliente su {{clientId}}
    3. Imposta il segreto del cliente su {{clientSecret}}
       
       
       
        
11. Scorri verso il basso e clicca su Get New Access Token. Postman dovrebbe informarti dell'avvenuta autenticazione. Clicca su Procedi e poi su Usa token.
    
     
12. Molto importante: clicca su Salva!
    
     

13. Clicca su: me → recupera l'Organizzazione corrente → Invia.

    Dovresti vedere una risposta dall'API pubblica di Motimate, con i dati della tua organizzazione.
    
    
    
     

    Congratulazioni! Ora hai importato l'API pubblica di Motimate nelle Collezioni di Postman 🎉