Motimate: Jak zaimportować dokumentację Motimate Public API do Postmana?

Wprowadzenie

Jeśli jesteś programistą API, wiesz, jak ważne jest testowanie i dokumentowanie aplikacji w celu zapewnienia jej funkcjonalności i niezawodności. Postman jest popularnym narzędziem wśród programistów, ponieważ zapewnia przyjazny dla użytkownika interfejs do wykonywania żądań HTTP, testowania punktów końcowych i wizualizacji odpowiedzi.

Jedną z kluczowych funkcji tego narzędzia jest możliwość importowania dokumentacji w formacie Open API. W tym artykule przeprowadzimy Cię przez proces importowania dokumentacji Motimate Public API (w formacie Open API 3.0) do Postman Collection, dzięki czemu testowanie i rozwój API będą bardziej wydajne.

Wymagania

Zanim zaczniemy, musisz mieć zainstalowanego Postmana w swoim systemie. Możesz pobrać Postman tutaj.

Zaimportuj Motimate API dla kolekcji Postman:

1. Przejdź do strony pobierania dokumentacji Motimate Public API(tutaj).
    
2. Znajdź przycisk Eksportuj w prawym górnym rogu i kliknij go. Wybierz Download API, a następnie JSON Unresolved.
    
3. Po pobraniu pliku otwórz aplikację Postman.
   
   
    
4. Otwórz kartę Kolekcje i kliknij przycisk Importuj. Prześlij pobrany plik jako kolekcję.
   
   
    
5. Czas skonfigurować naszą autoryzację - kliknij Motimate Public API, a następnie wybierz zakładkę Variables.
   
   
    

6. Dodaj nową zmienną o nazwie clientId i ustaw wartość Initial na wartość podaną przez Motimate. Bieżąca wartość zostanie zaktualizowana automatycznie.
   
   to...
   
    

   Dodaj nową zmienną o nazwie clientSecret i ustaw wartość Initial na wartość podaną przez Motimate. Bieżąca wartość zostanie zaktualizowana automatycznie.
   
   
   
    

7. Bardzo ważne: kliknij Zapisz!
   
   
   
    
8. Kliknij ponownie Motimate Public API i wybierz zakładkę Authorization.
   
   
    

9. Ustaw typ na OAuth 2.0. Powinien pojawić się formularz. Przewiń w dół do sekcji Konfiguruj nowy token.

   Jeśli zobaczysz informację "Some changes to the Token…", po prostu kliknij Edit Token Configuration.
   
   
   
    

10. Ustaw typ przyznania na Poświadczenia klienta:
    1. Ustaw adres URL tokenu dostępu na {{baseUrl}}/oauth/token
    2. Ustaw identyfikator klienta na {{clientId}}
    3. Ustaw Client Secret na {{clientSecret}}
       
       
       
        
11. Przewiń w dół i kliknij Pobierz nowy token dostępu. Postman powinien poinformować Cię o pomyślnym uwierzytelnieniu. Kliknij Kontynuuj, a następnie Użyj tokena.
    
     
12. Bardzo ważne: kliknij Zapisz!
    
     

13. Kliknij: Ja → Pobierz bieżącą organizację → Wyślij.

    Powinieneś zobaczyć odpowiedź z publicznego interfejsu API Motimate, zawierającą dane Twojej organizacji.
    
    
    
     

    Gratulacje! Zaimportowałeś teraz Motimate Public API do Postman Collections 🎉