Słownik

Długoterminowy token dostępu Facebooka i jego 60-dniowy zegar

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Długoterminowy token dostępu Facebooka i jego 60-dniowy zegarDługoterminowy token dostępu Facebooka i jego 60-dniowy zegar

TL;DR, szybka odpowiedź

8 min czytania

Meta wymienia krótkoterminowy token dostępu użytkownika na długoterminowy przez GET oauth/access_token z grant_type=fb_exchange_token. Odpowiedź zawiera expires_in 5183944 sekund, czyli o 56 sekund mniej niż 60 dni. Tokeny dostępu strony wygenerowane z długoterminowego tokenu użytkownika w ogóle nie mają daty wygaśnięcia. Meta zapowiada, że nigdy nie powiadomi cię o unieważnieniu tokenu, więc odczytuj expires_at z debug_token zamiast ufać liczbie 60 dni.

Czym jest długoterminowy token dostępu Facebooka?

Meta wydaje długoterminowy token dostępu Facebooka w zamian za krótkoterminowy, a według jej dokumentacji działa on około 60 dni. Wymiana to jedno wywołanie po stronie serwera. Powód jej istnienia podaje pierwsze zdanie przewodnika Meta: "Default User and Page access tokens are short-lived, expiring in hours, however, you can exchange a short-lived token for a long-lived token."

Różnicę Meta opisuje jednym zdaniem w przeglądzie tokenów dostępu: "Access tokens come in two forms: short-lived and long-lived. Short-lived tokens typically last about one to two hours, while long-lived tokens last about 60 days."

Kolejne zdanie jest tym, które większość integracji ignoruje. Meta pisze, że nie należy zakładać niezmienności tych okresów, bo "they may change without warning or expire early."

Jak wymienić token krótkoterminowy na długoterminowy?

Wywołujesz punkt końcowy GET oauth/access_token z grant_type=fb_exchange_token. Przykład curl od samej Meta:

curl -i -X GET "https://graph.facebook.com/{graph-api-version}/oauth/access_token?
    grant_type=fb_exchange_token&
    client_id={app-id}&
    client_secret={app-secret}&
    fb_exchange_token={your-access-token}"

Cztery parametry, z czego trzy są twoje. client_id to identyfikator aplikacji, client_secret to jej sekret, a fb_exchange_token to posiadany już krótkoterminowy token dostępu użytkownika. Odpowiedź:

{
  "access_token": "{long-lived-user-access-token}",
  "token_type": "bearer",
  "expires_in": 5183944
}

Meta opisuje expires_in w samym przykładzie jako "The number of seconds until the token expires." Warto to policzyć. Sześćdziesiąt dni to 5 184 000 sekund. Wartość z dokumentacji Meta to 5 183 944, czyli o 56 sekund mniej niż równe 60 dni. W praktyce ta różnica nie ma znaczenia, ale wiele mówi: podana liczba nie jest obietnicą dokładnie 60 dni, tylko przykładową wartością, a Meta zaznacza, że faktyczny okres może się zmienić.

Do wymiany dołączone są trzy zastrzeżenia, tu słowami Meta:

  • "You can not use an expired token to request a long-lived token." Gdy token krótkoterminowy wygaśnie, użytkownik musi zalogować się ponownie.
  • "Make this call from your server, not a client. Your app secret is included in this API call, so you should never make the request client-side."
  • "Do not use the same long-lived tokens on more than one web client."

Drugie zastrzeżenie zawiera też często pomijaną instrukcję dotyczącą przechowywania: token długoterminowy "will be a different string than the original token, so if you're storing these tokens, replace the old one."

Krótkoterminowy a długoterminowy w jednej tabeli

Krótkoterminowy token użytkownikaDługoterminowy token użytkownikaToken strony z długoterminowego tokenu użytkownika
Czas według dokumentacji"about one to two hours""about 60 days"Brak daty wygaśnięcia
Jak go uzyskaćLogowanie w przeglądarcegrant_type=fb_exchange_tokenGET {app-scoped-user-id}/accounts
Gdzie działa wywołanieKlient lub serwerTylko serwer, zawiera sekret aplikacjiSerwer
Przykładowe expires_inNie opublikowano5183944Nie jest zwracane

Wyjątkiem, który myli osoby czytające o integracjach webowych, są aplikacje mobilne. Meta pisze, że "Native mobile apps using Facebook's SDKs get long-lived User access tokens, good for about 60 days. These tokens are refreshed once per day, when the person using your app makes a request to Facebook's servers." Codzienne odświeżanie następuje tylko wtedy, gdy ktoś nadal korzysta z aplikacji, bo "If no requests are made, the token will expire after about 60 days."

Osoba pracuje na laptopie przy biurku, co symbolizuje konfigurację po stronie serwera, w której powstają tokeny dostępu strony.

Jeden token, trzy życia
1
Logowanie. Proces webowy wydaje krótkoterminowy token użytkownika, ważny około jednej do dwóch godzin.
2
Wymiana. Wywołanie po stronie serwera z grant_type=fb_exchange_token zamienia go na długoterminowy token użytkownika, ważny około 60 dni.
3
Token strony. Wywołanie krawędzi accounts z tym tokenem zwraca token dostępu strony bez żadnej daty wygaśnięcia.
Każda wymiana oddala token od 60-dniowego zegara, aż token strony całkiem się spod niego wymyka.

Dlaczego token dostępu strony działa inaczej?

Token dostępu strony uzyskany z długoterminowego tokenu użytkownika nie wygasa. Meta mówi to wprost: "Long-lived Page access token do not have an expiration date and only expire or are invalidated under certain conditions."

Uzyskasz go, wywołując krawędź accounts z długoterminowym tokenem użytkownika:

curl -i -X GET "https://graph.facebook.com/{graph-api-version}/{app-scoped-user-id}/accounts?
  access_token={long-lived-user-access-token}"

Odpowiedź zawiera po jednym obiekcie na stronę, a każdy ma własny access_token oraz category, name, id i tablicę tasks z wartościami takimi jak ANALYZE, ADVERTISE, MODERATE, CREATE_CONTENT i MANAGE. W tych danych nie ma expires_in, co potwierdza to samo twierdzenie już na poziomie struktury odpowiedzi.

Obowiązują dwa warunki. Meta wymaga, aby "The person requesting the token must have a role on the Page", a w innym miejscu zaznacza, że "Page access tokens are unique to each Page, admin, and app combination." Zmiana któregokolwiek z tych trzech elementów oznacza inny token, więc token strony nie przetrwa utraty roli przez administratora, który go utworzył.

To najważniejszy powód, dla którego integracje publikujące opierają się na tokenach strony, a nie użytkownika. Kolejka, która musi przetrwać 60-dniowy zegar, potrzebuje strategii odświeżania, a kolejka oparta na tokenie strony takiego zegara nie ma. Dlatego też połączenie konta na Instagramie ze stroną firmową na Facebooku ma znaczenie przy pracy z API, a nie tylko przy publikowaniu w obu miejscach: Instagram API z logowaniem przez Facebooka uwierzytelnia się tokenem dostępu strony.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Ikona kłódki na cyfrowym ekranie, symbolizująca zdarzenia bezpieczeństwa, które mogą przedwcześnie unieważnić token dostępu.

Co unieważnia token przed upływem 60 dni?

Meta nie publikuje pełnej listy. Strona o tokenach długoterminowych mówi, że tokeny strony "only expire or are invalidated under certain conditions", i w sprawie tych warunków odsyła do strony o debugowaniu. Ta z kolei podaje jedną ogólną przyczynę i trzy konkretne odpowiedzi z błędem, ale nigdy nie wylicza warunków w formie listy.

Ogólna przyczyna, w cytacie: "Due to security related events, access tokens may be invalidated before the expected expiration time."

Trzy udokumentowane błędy, każdy z kodem 190:

PodkodKomunikatCo go wywołało
463"Error validating access token: Session has expired on..."Token osiągnął czas wygaśnięcia
460"Error validating access token: The session is invalid because the user logged out."Meta: "a person logged out of your app or changed their password"
458"Error validating access token: User {user-id} has not authorized application {your-app-id}."Autoryzacja cofnięta lub nigdy nieudzielona

Zespoły najczęściej zaskakuje zmiana hasła, bo unieważnia tokeny bez winy integracji i nie daje żadnego sygnału. Meta wprost mówi o braku takiego sygnału: "Facebook will not notify you that an access token has become invalid. Unless you have sent the expiry time to your app along with the access token, your app may only learn that a given token has become invalid when you attempt to make a request to the API."

To zdanie jest sednem całego tematu od strony operacyjnej. Nie ma webhooka dla unieważnionego tokenu. Większość zespołów odkrywa problem przy zaplanowanym poście, dlatego nieważny token jest wysoko na liście powodów, dla których zaplanowane posty na Facebooku przestają działać, choć po stronie publikacji nic się wyraźnie nie zmieniło.

Jak sprawdzić, ile czasu naprawdę zostało tokenowi?

Zamiast ufać liczbie 60 dni, odpytaj debug_token:

curl -i -X GET "https://graph.facebook.com/debug_token?
  input_token={input-token}&
  access_token={valid-access-token}"

Meta dodaje jedno ograniczenie: "The tokens must be from the same app." Odpowiedź zwraca app_id, type, application, expires_at, data_access_expires_at, is_valid, scopes, granular_scopes i user_id, a Meta zaznacza, że "For long-lived access tokens the issued_at field is also returned."

Dwa z tych pól to osobne zegary, które nieustannie się myli. expires_at to moment, w którym token przestaje działać. data_access_expires_at to inny termin, dotyczący dalszego dostępu do danych użytkownika. Token może być ważny według pierwszego, a ograniczony przez drugi.

Wbuduj to sprawdzenie w proces publikacji, a nie w instrukcję dla zespołu. Odczyt expires_at przed publikacją kosztuje jedno żądanie i zamienia cichą awarię w zaplanowaną ponowną autoryzację, tak jak odczyt content_publishing_limit na Instagramie przed publikacją zamienia limit w decyzję o kolejce. W obu przypadkach tani odczyt zastępuje nieprzewidywalny błąd liczbą, którą można przewidzieć.

Jedna grupa aplikacji całkowicie unika tego zegara. Meta pisze, że "Apps with Standard access to the Marketing API receive long-lived tokens that do not expire based on time, though they are still subject to invalidation for other reasons", i rozszerza to na tokeny użytkowników systemowych w Business Managerze. Czas przestaje być przyczyną awarii, ale unieważnienia po zdarzeniach bezpieczeństwa nadal się zdarzają.

Najczęściej zadawane pytania

Jak długo działa długoterminowy token dostępu Facebooka?

Około 60 dni. Przykładowa odpowiedź Meta zwraca expires_in: 5183944 sekund, czyli o 56 sekund mniej niż 60 dni, a Meta ostrzega, że okres ważności "may change without warning."

Jaki jest dokładny punkt końcowy wymiany?

GET https://graph.facebook.com/{graph-api-version}/oauth/access_token z parametrami grant_type=fb_exchange_token, client_id, client_secret i fb_exchange_token. Musi działać po stronie serwera, bo zawiera sekret aplikacji.

Czy można odświeżyć token długoterminowy przed wygaśnięciem?

Meta dokumentuje wymianę tylko z tokenu krótkoterminowego na długoterminowy i stwierdza, że "You can not use an expired token to request a long-lived token." Nie opisuje odświeżania już długoterminowego tokenu użytkownika w przeglądarce.

Czy tokeny dostępu strony kiedykolwiek wygasają?

Meta podaje, że tokeny strony wygenerowane z długoterminowego tokenu użytkownika "do not have an expiration date and only expire or are invalidated under certain conditions", ale nigdy nie publikuje tych warunków w formie pełnej listy.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Czy Facebook powiadomi cię o unieważnieniu tokenu?

Nie. Dokumentacja Meta mówi wprost, że "Facebook will not notify you that an access token has become invalid", a aplikacja może się o tym dowiedzieć dopiero przy nieudanym żądaniu.

Który błąd oznacza, że użytkownik zmienił hasło?

Kod 190, podkod 460, z komunikatem "Error validating access token: The session is invalid because the user logged out." Meta przypisuje tę odpowiedź osobie, która "logged out of your app or changed their password."

Co się stanie, jeśli token krótkoterminowy wygaśnie przed wymianą?

Meta całkowicie blokuje wymianę: "You can not use an expired token to request a long-lived token." Token krótkoterminowy musi być aktywny w chwili wywołania oauth/access_token, więc jeśli zwlekasz zbyt długo po logowaniu, jedynym rozwiązaniem jest ponowne przeprowadzenie użytkownika przez logowanie.

Czy jeden token długoterminowy może obsługiwać dwa różne klienty webowe?

Zastrzeżenie Meta jest jednoznaczne: "Do not use the same long-lived tokens on more than one web client." Każdy klient webowy powinien wykonać własną wymianę i przechowywać własny token, zamiast współdzielić jeden między usługami.

Co się dzieje z ciągiem tokenu krótkoterminowego po wymianie?

Zwrócony token długoterminowy "will be a different string than the original token", więc miejsce przechowywania tokenu krótkoterminowego wymaga aktualizacji. Instrukcja Meta jest bezpośrednia: jeśli przechowujesz te tokeny, zastąp stary nowym, zamiast trzymać oba.

Czy tokeny Marketing API podlegają temu samemu 60-dniowemu zegarowi?

Według dokumentacji Meta aplikacje ze standardowym dostępem do Marketing API otrzymują tokeny długoterminowe, które nie wygasają z upływem czasu, choć nadal można je unieważnić z innych powodów. Ten sam wyjątek Meta rozszerza na tokeny użytkowników systemowych w Business Managerze. Zegar 60 dni po prostu ich nie dotyczy, ale unieważnienia po zdarzeniach bezpieczeństwa już tak.

Czy ten artykuł był pomocny?

Chętnie poznamy opinię!

Więcej naszych treści w Google

Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.

Jeszcze chwila...

AdaptlyPost

AdaptlyPost

Planowanie treści na wszystkich platformach

Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Powiązane hasła ze słownika

Powiązane artykuły