Motimate: Hoe importeer ik Motimate Public API Documentation naar Postman?

Inleiding

Als je een API-ontwikkelaar bent, weet je hoe belangrijk het is om je applicatie te testen en te documenteren om de functionaliteit en betrouwbaarheid ervan te garanderen. Postman is een populair hulpmiddel onder ontwikkelaars omdat het een gebruiksvriendelijke interface biedt om HTTP-verzoeken te doen, endpoints te testen en reacties te visualiseren.

Een van de belangrijkste functies van deze tools is de mogelijkheid om documentatie in Open API-indeling te importeren. In dit artikel leiden we je door het proces van het importeren van Motimate Public API documentatie (in Open API 3.0 formaat) in een Postman Collection, waardoor je API testen en ontwikkelen efficiënter wordt.

Vereisten

Voordat we beginnen, moet Postman geïnstalleerd zijn op je systeem. Je kunt Postman hier downloaden .

Motimate API importeren voor Postman Verzamelingen:

1. Ga naar de pagina voor het downloaden van de Motimate Public API documentatie(hier).
    
2. Zoek de knop Exporteren in de rechterbovenhoek en klik erop. Selecteer Download API en vervolgens JSON Unresolved.
    
3. Zodra het bestand is gedownload, open je Postman.
   
   
    
4. Open het tabblad Collecties en klik op Importeren. Upload het gedownloade bestand als een Collectie.
   
   
    
5. Tijd om onze autorisatie in te stellen - klik op Motimate Public API en selecteer dan het tabblad Variables.
   
   
    

6. Voeg een nieuwe variabele toe met de naam clientId en stel de beginwaarde in op de waarde die is opgegeven door Motimate. De huidige waarde wordt automatisch bijgewerkt.
   
   dan...
   
    

   Voeg een nieuwe variabele toe met de naam clientSecret en stel de beginwaarde in op de waarde die is opgegeven door Motimate. De huidige waarde wordt automatisch bijgewerkt.
   
   
   
    

7. Heel belangrijk: klik op Opslaan!
   
   
   
    
8. Klik opnieuw op Motimate Public API en selecteer het tabblad Authorization.
   
   
    

9. Stel Type in op OAuth 2.0. Er zou een formulier moeten verschijnen. Scroll naar beneden naar de sectie Nieuwe tokens configureren.

   Als je de melding "Some changes to the Token…" ziet, klik je gewoon op Tokenconfiguratie bewerken.
   
   
   
    

10. Zet Grant type op Client Credentials:
    1. URL voor toegangskenmerk instellen op {{baseUrl}}/oauth/token
    2. Stel Client-ID in op {{clientId}}
    3. Stel Clientgeheim in op {{clientSecret}}
       
       
       
        
11. Scroll naar beneden en klik op Get New Access Token. Postman zou je moeten informeren over een succesvolle authenticatie. Klik op Doorgaan en vervolgens op Token gebruiken.
    
     
12. Heel belangrijk: klik op Opslaan!
    
     

13. Klik op: mij → huidige organisatie ophalen → verzenden.

    Je zou een antwoord moeten zien van de Motimate Public API, met de gegevens van je organisatie.
    
    
    
     

    Gefeliciteerd! Je hebt nu de Motimate Public API geïmporteerd in Postman Collections 🎉