Motimate: Hvordan importerer jeg Motimate Public API Documentation til Postman?

Introduktion

Hvis du er API-udvikler, ved du, hvor vigtigt det er at teste og dokumentere din applikation for at sikre dens funktionalitet og pålidelighed. Postman er et populært værktøj blandt udviklere, da det giver en brugervenlig grænseflade til at lave HTTP-anmodninger, teste slutpunkter og visualisere svar.

En af de vigtigste funktioner i dette værktøj er muligheden for at importere dokumentation i Open API-format. I denne artikel vil vi guide dig gennem processen med at importere Motimate Public API-dokumentation (i Open API 3.0-format) til en Postman Collection, hvilket gør din API-testning og -udvikling mere effektiv.

Kravene

Før vi går i gang, skal du have Postman installeret på dit system. Du kan downloade Postman her.

Importer Motimate API til Postman Collections:

1. Gå til siden, hvor du kan downloade dokumentationen til Motimate Public API(her).
    
2. Find knappen Eksport i øverste højre hjørne, og klik på den. Vælg Download API og derefter JSON Unresolved.
    
3. Når filen er downloadet, skal du åbne Postman.
   
   
    
4. Åbn fanen Samlinger , og klik på Importer. Upload den downloadede fil som en samling.
   
   
    
5. Det er tid til at sætte vores autorisation op - klik på Motimate Public API, og vælg derefter fanen Variables.
   
   
    

6. Tilføj en ny variabel med navnet clientId, og indstil Initial value til den værdi, der er angivet af Motimate. Den aktuelle værdi opdateres automatisk.
   
   Og så...
   
    

   Tilføj en ny variabel med navnet clientSecret, og sæt Initial-værdien til den værdi, der er angivet af Motimate. Den aktuelle værdi opdateres automatisk.
   
   
   
    

7. Meget vigtigt: Klik på Gem!
   
   
   
    
8. Klik på Motimate Public API igen, og vælg fanen Authorization.
   
   
    

9. Sæt Type til OAuth 2.0. En formular bør dukke op. Rul ned til afsnittet Configure New Token.

   Hvis du ser informationen "Some changes to the Token…", skal du blot klikke på Edit Token Configuration.
   
   
   
    

10. Sæt Grant type til Client Credentials:
    1. Indstil adgangstoken-URL til {{baseUrl}}/oauth/token
    2. Sæt klient-id til {{clientId}}
    3. Sæt klientens hemmelighed til {{clientSecret}}
       
       
       
        
11. Rul ned, og klik på Get New Access Token. Postman bør informere dig om en vellykket autentificering. Klik på Fortsæt og derefter på Brug token.
    
     
12. Meget vigtigt: Klik på Gem!
    
     

13. Klik: mig → hent nuværende organisation → send.

    Du bør se et svar fra Motimate Public API med dine organisationsdata.
    
    
    
     

    Tillykke! Du har nu importeret Motimate Public API til Postman Collections 🎉.