Motimate: Cách nhập tài liệu API công khai của Motimate vào Postman?

Giới thiệu

Nếu bạn là một nhà phát triển API, bạn hiểu rõ tầm quan trọng của việc kiểm thử và tài liệu hóa ứng dụng của mình để đảm bảo tính năng và độ tin cậy của nó. Postman là một công cụ phổ biến trong cộng đồng lập trình viên vì nó cung cấp giao diện thân thiện với người dùng để thực hiện các yêu cầu HTTP, kiểm thử các điểm cuối (endpoints) và hiển thị kết quả phản hồi.

Một trong những tính năng chính của công cụ này là khả năng nhập tài liệu ở định dạng Open API. Trong bài viết này, chúng tôi sẽ hướng dẫn bạn cách nhập tài liệu API công khai của Motimate (dạng Open API 3.0) vào bộ sưu tập Postman, giúp quá trình kiểm thử và phát triển API của bạn trở nên hiệu quả hơn.

Yêu cầu

Trước khi bắt đầu, bạn cần cài đặt Postman trên hệ thống của mình. Bạn có thể tải xuống Postman tại đây.

Nhập API Motimate vào bộ sưu tập Postman:

1. Truy cập trang tải xuống tài liệu API công khai Motimate (tại đây).
    
2. Tìm nút Xuất ở góc trên bên phải và nhấp vào nó. Chọn API Tải xuống, sau đó chọn JSON Chưa giải quyết.
    
3. Sau khi tệp đã được tải xuống, hãy mở Postman.
   
   
    
4. Mở tab Bộ sưu tập và nhấp vào Nhập. Tải lên tệp đã tải xuống dưới dạng Bộ sưu tập.
   
   
    
5. Đã đến lúc thiết lập quyền truy cập của chúng ta - nhấp vào Motimate Public API và sau đó chọn tab Biến.
   
   
    

6. Thêm một biến mới có tên clientId và đặt giá trị ban đầu của nó là giá trị do Motimate cung cấp. Giá trị hiện tại sẽ được cập nhật tự động.
   
   rồi...
   
    

   Thêm một biến mới có tên clientSecret và đặt giá trị ban đầu của nó là giá trị do Motimate cung cấp. Giá trị hiện tại sẽ được cập nhật tự động.
   
   
   
    

7. Rất quan trọng: Nhấp vào Lưu!
   
   
   
    
8. Nhấp vào Motimate Public API một lần nữa và chọn tab" Authorization".
   
   
    

9. Đặt loại thành OAuth 2.0. Một biểu mẫu sẽ hiển thị. Cuộn xuống phần " Cấu hình Token mới ".

   Nếu bạn thấy thông báo "Một số thay đổi đối với thông tin Token…", hãy nhấp vào " Chỉnh sửa cấu hình Token".
   
   
   
    

10. Đặt loại cấp phép thành Thông tin đăng nhập của khách hàng:
    1. Đặt URL Token Truy cập thành {{baseUrl}}/oauth/token
    2. Đặt ID Khách hàng thành {{clientId}}
    3. Đặt Khóa bí mật của khách hàng thành {{clientSecret}}
       
       
       
        
11. Cuộn xuống và nhấp vào " Get New Access Token". Postman sẽ thông báo cho bạn về việc xác thực thành công. Nhấp vào " Tiếp tục " và sau đó chọn " Sử dụng Token".
    
     
12. Rất quan trọng: Nhấp vào Lưu!
    
     

13. Nhấp vào: tôi → Lấy thông tin tổ chức hiện tại → Gửi.

    Bạn sẽ nhận được phản hồi từ API công khai Motimate, bao gồm dữ liệu tổ chức của bạn.
    
    
    
     

    Xin chúc mừng! Bạn đã nhập API công khai Motimate vào bộ sưu tập Postman 🎉