Motimate: Làm thế nào để nâng cấp từ Public API v1 lên v2?

Giao diện lập trình ứng dụng công khai phiên bản 2 (PAPI v2) của chúng tôi hiện đã được ra mắt, mang đến dịch vụ linh hoạt và hữu ích hơn ✨

Điều gì sẽ mới?

Với PAPI v2, bạn có thể truy cập vào phạm vi dữ liệu rộng hơn trên nhiều điểm cuối hơn. Cụ thể, bạn sẽ có thể xuất nhiều dữ liệu hơn và có thêm quyền kiểm soát đối với MotiSpace của mình thông qua API.

Bạn phải làm gì?

Chưa có gì cả. Hiện tại, chúng tôi đã chính thức ra mắt phiên bản mới và cho phép những ai quan tâm có thể bắt đầu sử dụng nó. Hiện tại, sẽ không có bất kỳ thay đổi nào được áp đặt lên bất kỳ ai. Vui lòng đọc phần dưới đây để biết thêm thông tin về thời gian dự kiến và thời điểm chúng tôi mong đợi mọi người thực hiện các biện pháp nâng cấp (thời gian này vẫn chỉ là dự kiến).

Làm thế nào để tôi có thể thử nghiệm phiên bản v2 mà không cần nâng cấp hoàn toàn?

Để bắt đầu sử dụng PAPI v2 trong khi vẫn duy trì tích hợp kỹ thuật với v1, hãy thêm tiêu đề HTTP motimate-public-api-version phải được đặt thành: v2.

Khi bạn đã sẵn sàng chuyển sang phiên bản v2 một cách vĩnh viễn, hãy thông báo cho bộ phận Hỗ trợ và họ sẽ cấu hình điều này ở phía máy chủ để tiêu đề này trở nên lỗi thời.

Nếu bạn đã thử nghiệm phiên bản v2 trong giai đoạn beta, bạn không cần phải thực hiện bất kỳ thay đổi nào, vì phiên bản v2 không có sự thay đổi so với phiên bản beta.

Việc nâng cấp lên phiên bản v2 có yêu cầu thay đổi lớn đối với triển khai hiện tại của chúng ta ở phiên bản v1 không?

Việc chuyển sang PAPI v2 không yêu cầu những thay đổi lớn, vì chủ yếu chỉ là những điều chỉnh nhỏ trong việc sử dụng các điểm cuối Users, Groups và Positions của chúng tôi. Nói cách khác, khách hàng sử dụng các nhà phát triển bên thứ ba hoặc tư vấn viên sẽ cần một khoảng thời gian nhất định để cập nhật và kiểm thử các tích hợp của họ.

Có gì thay đổi liên quan đến việc xác thực?

Không có gì thay đổi, miễn là bạn đã sử dụng PAPI v1, bạn vẫn sẽ sử dụng cùng một thông tin đăng nhập mà bạn đã nhận được từ đội ngũ Motimate khi lần đầu tiên yêu cầu truy cập API để nhận các token xác thực 24h của mình.

Phiên bản v1 có bị loại bỏ không? Thời gian thực hiện là bao lâu?

Trước tiên, chúng tôi đã chính thức ra mắt PAPI v2 và cho phép người dùng nâng cấp và bắt đầu sử dụng nó. 

Trong tương lai gần, chúng tôi sẽ thông báo rằng chúng tôi sẽ ngừng hỗ trợ phiên bản v1, và từ thời điểm đó, chúng tôi sẽ cung cấp một khoảng thời gian chuyển đổi 6 tháng để tất cả người dùng có thể chuyển sang phiên bản v2. Lưu ý rằng đây là kế hoạch tạm thời và có thể thay đổi.