Interfejs Google Health API korzysta z solidnego i ustandaryzowanego systemu zarządzania dostępem do danych użytkownika i ich bezpieczeństwem. Głównym elementem tej modernizacji jest przejście ze starszej autoryzacji Fitbita (FOT) na Google OAuth 2.0. Ta zmiana umożliwia deweloperom korzystanie ze standardowych bibliotek uwierzytelniania Google, co upraszcza implementację, a użytkownikom zapewnia znajomy i scentralizowany interfejs do zarządzania uprawnieniami.
Rejestracja aplikacji
Wszystkie aplikacje korzystające z interfejsu Google Health API muszą być zarejestrowane w konsoli Google Cloud, która służy jako centralne miejsce do zarządzania wszystkimi aplikacjami Google.
Instrukcje rejestrowania aplikacji znajdziesz w artykule Pierwsze kroki. Oto różnice, które zauważysz podczas rejestrowania aplikacji.
| Fitbit Web API | Google Health API | |
| Linki publiczne | https://dev.fitbit.com/apps | https://console.cloud.google.com |
| Dodawanie nowej aplikacji | Kliknij Zarejestruj nową aplikację. |
|
| Podstawowe informacje | Pola do wypełnienia:
|
Pola do wypełnienia:
|
| Typy aplikacji | Deweloper musi wybrać:
|
|
| Identyfikator klienta | Rejestrowane po zapisaniu ustawień aplikacji | Zarejestrowane osobno |
| Typ dostępu | Uprawnienia do odczytu i zapisu są kontrolowane na poziomie aplikacji | Uprawnienia do odczytu i zapisu są kontrolowane na poziomie zakresu. |
| Dodatkowe adresy URL |
|
|
Implementacja protokołu OAuth
Aplikacje korzystające z interfejsu Google Health API obsługują tylko biblioteki klienta Google OAuth2. Biblioteki klienta są dostępne dla popularnych platform, co upraszcza implementację protokołu OAuth 2.0.
Różnice między bibliotekami Google OAuth2 a bibliotekami OAuth2 open source są następujące:
| Fitbit Web API | Google Health API | |
| Obsługa biblioteki OAuth2 | Oprogramowanie typu open source | Biblioteki klienta Google OAuth2 |
| Funkcje | Niespójne na różnych platformach | Spójność na różnych platformach |
| Adres URL autoryzacji | https://www.fitbit.com/oauth2/authorize | https://accounts.google.com/o/oauth2/v2/auth |
| URL tokena | https://api.fitbit.com/oauth2/token | https://oauth2.googleapis.com/token |
| Czas ważności tokena dostępu | 8 godzin | 1 godzina |
| Rozmiar tokena dostępu | 1024 bajty | 2048 bajtów |
| Token odświeżania | Tokeny odświeżania są generowane podczas korzystania z przepływu przyznawania kodu autoryzacji. Dla użytkownika można wygenerować tylko 1 token odświeżania. Tokeny nigdy nie wygasają i można ich użyć tylko raz. | Aby wygenerować token odświeżania, ciąg autoryzacji musi zawierać parametr zapytania „access_type=offline”. Dla jednego użytkownika można utworzyć wiele tokenów odświeżania. Tokeny odświeżania mogą być oparte na czasie. Jeśli nie będą używane przez 6 miesięcy, użytkownik przyznał dostęp na określony czas lub aplikacja jest w trybie „Testowanie”, wygasną. Więcej informacji znajdziesz w sekcji Wygaśnięcie tokena odświeżania. |
| Odpowiedź tokena | Odpowiedź JSON zawiera:
|
Odpowiedź JSON zawiera:
Aby uzyskać identyfikator użytkownika, wywołaj punkt końcowy users.getIdentity po przyznaniu co najmniej 1 zakresu Google Health i utrzymuj starsze tokeny Fitbita jako aktywne do momentu zweryfikowania legacyUserId.
|
Ponowne uwierzytelnianie użytkownika (obowiązkowe ponowne wyrażenie zgody)
Użytkownicy Fitbita muszą ponownie wyrazić zgodę na nową integrację, ponieważ Twoja aplikacja korzysta z innej biblioteki OAuth. Nie można przenieść tokenów dostępu i tokenów odświeżania do interfejsu API Google Health i ich używać.
Każdy użytkownik, który ponownie wyrazi zgodę, jest wliczany do limitu przyznawania tokenów OAuth w projekcie Google Cloud. Google Cloud wymusza ograniczanie liczby żądań przyznawania tokenów OAuth, aby kontrolować, jak szybko aplikacja może rejestrować lub ponownie uwierzytelniać użytkowników. Jeśli spodziewasz się,że w ciągu 24 godzin przekroczysz 10 000 rejestracji lub ponownych uwierzytelnień użytkowników, poproś o zwiększenie limitu z wyprzedzeniem. Więcej informacji znajdziesz w artykule na temat ograniczeń liczby żądań aplikacji OAuth.