API Google Health sử dụng một khung mạnh mẽ và được chuẩn hoá để quản lý quyền truy cập và bảo mật dữ liệu người dùng. Một thành phần chính của quá trình hiện đại hoá này là việc chuyển đổi từ cơ chế uỷ quyền cũ của Fitbit (FOT) sang Google OAuth 2.0. Sự thay đổi này cho phép nhà phát triển tận dụng các thư viện xác thực tiêu chuẩn của Google, đơn giản hoá việc triển khai, đồng thời cung cấp cho người dùng một giao diện quen thuộc và tập trung để quản lý quyền của họ.
Đăng ký ứng dụng
Tất cả ứng dụng Google Health API đều phải được đăng ký bằng Google Cloud Console, đóng vai trò là trung tâm để quản lý tất cả ứng dụng của Google.
Để biết hướng dẫn về cách đăng ký ứng dụng, hãy làm theo các bước trong phần Bắt đầu. Sau đây là những điểm khác biệt mà bạn sẽ nhận thấy khi đăng ký ứng dụng.
| Fitbit Web API | API Google Health | |
| Đường liên kết công khai | https://dev.fitbit.com/apps | https://console.cloud.google.com |
| Thêm ứng dụng mới | Nhấn vào Đăng ký ứng dụng mới |
|
| Thông tin cơ bản | Các trường cần hoàn tất:
|
Các trường cần hoàn tất:
|
| Loại ứng dụng | Nhà phát triển phải chọn:
|
|
| Mã ứng dụng khách | Được đăng ký khi chế độ cài đặt ứng dụng được lưu | Đăng ký riêng |
| Loại quyền truy cập | Quyền đọc và ghi được kiểm soát ở cấp ứng dụng | Quyền đọc và ghi được kiểm soát ở cấp phạm vi |
| URL bổ sung |
|
|
Triển khai OAuth
Các ứng dụng API Google Health chỉ hỗ trợ Thư viện ứng dụng Google OAuth2. Thư viện ứng dụng có sẵn cho các khung phổ biến, giúp việc triển khai OAuth 2.0 trở nên đơn giản hơn.
Sự khác biệt giữa thư viện Google OAuth2 và thư viện OAuth2 nguồn mở như sau:
| Fitbit Web API | API Google Health | |
| Hỗ trợ thư viện OAuth2 | Nguồn mở | Thư viện ứng dụng Google OAuth2 |
| Chức năng | Không nhất quán trên các nền tảng | Nhất quán trên nhiều nền tảng |
| URL uỷ quyền | https://www.fitbit.com/oauth2/authorize | https://accounts.google.com/o/oauth2/v2/auth |
| URL mã thông báo | https://api.fitbit.com/oauth2/token | https://oauth2.googleapis.com/token |
| Thời gian hoạt động của mã truy cập | 8 giờ | 1 giờ |
| Kích thước mã truy cập | 1024 byte | 2048 byte |
| Mã làm mới | Mã làm mới được tạo khi sử dụng Quy trình cấp mã uỷ quyền. Chỉ có thể tạo 1 mã làm mới cho một người dùng. Mã thông báo không bao giờ hết hạn và chỉ có thể sử dụng một lần. | Để tạo mã làm mới, chuỗi uỷ quyền phải chứa tham số truy vấn "access_type=offline". Bạn có thể tạo nhiều mã làm mới cho một người dùng. Mã làm mới có thể dựa trên thời gian. Mã này sẽ hết hạn nếu không được sử dụng trong vòng 6 tháng, người dùng cấp quyền truy cập theo thời gian hoặc ứng dụng đang ở chế độ "Thử nghiệm". Hãy xem phần Hết hạn mã làm mới để biết thêm thông tin. |
| Phản hồi bằng mã thông báo | Nội dung phản hồi JSON chứa:
|
Nội dung phản hồi JSON chứa:
Để lấy mã nhận dạng người dùng, hãy gọi điểm cuối users.getIdentity một lần khi ít nhất một phạm vi của Google Health được cấp và duy trì hoạt động của mã thông báo Fitbit cũ cho đến khi legacyUserId được xác minh.
|
Xác thực lại người dùng (Bắt buộc phải đồng ý lại)
Người dùng Fitbit phải đồng ý lại với chế độ tích hợp mới của bạn, vì ứng dụng của bạn đang sử dụng một thư viện OAuth khác. Bạn không thể chuyển mã truy cập và mã làm mới sang Google Health API để sử dụng.
Mỗi người dùng đồng ý lại sẽ được tính vào giới hạn cấp mã thông báo OAuth của dự án trên đám mây trên Google Cloud. Google Cloud áp dụng giới hạn tốc độ đối với việc cấp mã thông báo OAuth để kiểm soát tốc độ ứng dụng của bạn có thể thu nạp hoặc xác thực lại người dùng. Nếu bạn dự kiến sẽ vượt quá 10.000 lượt đăng ký hoặc xác thực lại của người dùng trong khoảng thời gian 24 giờ, hãy yêu cầu hạn mức cao hơn trước. Để biết thêm thông tin, hãy xem bài viết Giới hạn về tốc độ của ứng dụng OAuth.