長期存取權杖

Instagram 用戶存取權杖預設為短期存取權杖，有效時間為 1 小時。不過，您可以將短期權杖換成長期權杖。

長期權杖的有效時間為 60 天，只要其至少存在 24 小時但尚未失效，且應用程式用戶已授予應用程式 instagram_graph_user_profile 權限，就可以重新整理。已重新整理的權杖有效時間為自重新整理之日起 60 天。60 天內未重新整理的權杖將失效，且無法再重新整理。

限制

• 無法將已失效的短期權杖換成長期權杖。如果用戶的權杖已失效，請先取得新權杖，再將其換成長期權杖。
• 針對長期權杖的要求會包含您的應用程式密鑰，因此只能以伺服器端程式碼進行，切勿以用戶端程式碼進行，或是以可能被反編譯的應用程式二進位檔進行。請勿將您的應用程式密鑰與任何人分享、在程式碼中公開、傳送至用戶端或儲存在裝置中。

取得長期權杖

使用 GET /access_token 端點可將短期 Instagram 用戶存取權杖換成長期權杖。取得長期權杖後，您可以在伺服器端要求中使用權杖，也可以傳送至用戶端並從該處使用權杖。

您的要求必須在伺服器端進行並包含：

• 有效（未過期）的短期 Instagram 用戶存取權杖
• 您的 Instagram 應用程式密鑰（應用程式主控板 > 產品 > Instagram > 基本顯示 > Instagram 應用程式密鑰）

如需其他資訊，請參閱 GET /access_token 參考資料。

要求範例

curl -i -X GET "https://graph.instagram.com/access_token
  ?grant_type=ig_exchange_token
  &client_secret={instagram-app-secret}
  &access_token={short-lived-access-token}"

回應範例

{
  "access_token":"{long-lived-user-access-token}",
  "token_type": "bearer",
  "expires_in": 5183944  // Number of seconds until token expires
}

重新整理長期權杖

使用 GET /refresh_access_token 端點可重新整理未失效的長期 Instagram 用戶存取權杖。重新整理長期權杖可使其再次獲得 60 天的有效時間。60 天內未重新整理的長期權杖將失效。

您的要求必須包含：

• 有效（未過期）的長期 Instagram 用戶存取權杖

如需其他資訊，請參閱 GET /refresh_access_token 參考資料。

要求範例

curl -i -X GET "https://graph.instagram.com/refresh_access_token
  ?grant_type=ig_refresh_token
  &access_token={long-lived-access-token}"

回應範例

{
  "access_token":"{long-lived-user-access-token}",
  "token_type": "bearer",
  "expires_in": 5183944 // Number of seconds until token expires
}