登入開始免費試用
easyCoexistence 官方 API

Instagram 存取權杖:長效權杖、60 天有效期與更新

Instagram 長效存取權杖有效期為 60 天,只要未過期且已滿 24 小時,即可再更新 60 天。使用 Instagram Login 登入後,會取得有效一小時的 Instagram 用戶短期存取權杖,應用程式的伺服器再將其換成長效權杖。

easyCoexistence 會為您保持 Instagram 權杖有效:在 60 天期限屆滿前更新存取權限,每 6 小時檢查帳戶,並在需要重新連接時電郵通知您,讓 Claude、ChatGPT 或您自己的程式碼都能以保持有效的權杖呼叫 Meta 官方 API。

1 hour

從登入取得的短期 Instagram 用戶存取權杖有效時間。

60 days

更新後的長效權杖,由更新當日起計的有效時間。

24 hours

Meta 更新長效權杖前,權杖須達到的最短時間。

Once

每次登入的授權代碼可交換的次數;代碼有效期為 1 小時。

Instagram Login 使用哪種權杖?

Instagram 用戶存取權杖。它遵循 OAuth 2.0,以應用程式為範圍,包含應用程式、到期時間、該帳戶的 Instagram 用戶 ID 及已授予的權限;每次呼叫 graph.instagram.com 時都會附上。Facebook Login 則使用 Facebook 用戶或專頁存取權杖,Unified Login 則使用商務整合系統用戶存取權杖。

應用程式如何取得長效權杖?

登入後須在伺服器上進行兩次交換。登入會以代碼重新導向,代碼有效期為一小時,只可使用一次。以 Instagram 應用程式 ID 及密鑰呼叫 POST https://api.instagram.com/oauth/access_token,即可換取短期權杖、該帳戶以應用程式為範圍的用戶 ID,以及已授予的權限。隨後以 grant_type=ig_exchange_token 及應用程式密鑰呼叫 GET https://graph.instagram.com/access_token,即可取得長效權杖,其中 expires_in 以秒為單位。

1LoginRedirect with a code, valid 1 hour, usable once
2Short-lived tokenFrom api.instagram.com/oauth/access_token, valid 1 hour
3Long-lived tokenFrom graph.instagram.com/access_token, valid 60 days
4RefreshFrom graph.instagram.com/refresh_access_token, 60 more days

如何更新長效權杖?

呼叫 GET https://graph.instagram.com/refresh_access_token,並附上 grant_type=ig_refresh_token 及現有的長效權杖。回應中的權杖自更新當日起計有效 60 天。Meta 只會在以下三個條件同時成立時更新:

  • 權杖為長效權杖,且已滿 24 小時。
  • 權杖尚未過期。
  • 帳戶擁有者已授予 instagram_business_basic 權限。
Refreshing a long-lived token
GET https://graph.instagram.com/refresh_access_token
  ?grant_type=ig_refresh_token
  &access_token=<LONG_LIVED_TOKEN>

{
  "access_token": "<NEW_LONG_LIVED_TOKEN>",
  "token_type": "bearer",
  "expires_in": 5183944
}

權杖過期後會怎樣?

權杖會永久失效。長效權杖若在 60 天內未更新,便會過期且無法再更新,以之呼叫的請求會因 Graph API 錯誤 190(access token expired)而失敗。要恢復運作,唯一方法是由帳戶擁有者重新登入,這會重新開始交換程序。

為何交換必須在伺服器上進行?

因為交換過程需要攜帶應用程式密鑰。Meta 表示,長效權杖的請求應置於伺服器端程式碼,切勿放在用戶端程式碼或可被反編譯的應用程式檔案內,密鑰亦不應分享、傳送至用戶端或儲存於裝置上。

如何在不處理權杖的情況下,透過 easyCoexistence 呼叫 Instagram?

透過 MCP 工具。publish_instagram_post、list_social_posts、list_social_comments、reply_to_comment、hide_comment、send_social_dm 及 get_social_insights 會以該帳戶身分運作,easyCoexistence 在其端加入權杖。Instagram 權杖絕不會提供(依 Meta 條款),因此 get_social_credentials 只會回傳 Instagram 帳戶 ID 及 API 基底網址;權杖及其續期仍由 easyCoexistence 負責。

常見錯誤

  • 在瀏覽器或手機應用程式中交換權杖。呼叫會攜帶應用程式密鑰,而 Meta 表示密鑰必須留在伺服器端程式碼中。
  • 在權杖的第一天就更新。Meta 只會在長效權杖至少滿 24 小時後才更新。
  • 重複使用授權代碼。代碼有效期為一小時,且只可使用一次;第二次交換會被拒絕。
  • 在 Instagram Login 中使用 Meta 應用程式 ID 及密鑰。Business Login for Instagram 須使用 App Dashboard 的 Instagram 設定中的 Instagram 應用程式 ID 及密鑰。
使用 EasyCoexistence 完成這項設定

每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費。

常見問題

Instagram 存取權杖有效多久?

短期權杖有效一小時。長效權杖有效 60 天,並可再更新 60 天。

Instagram 授權代碼有效多久?

一小時,且只可交換一次;使用同一代碼再次交換會被拒絕。

Instagram Login 使用哪個應用程式 ID 及密鑰?

App Dashboard 的 Instagram 設定中所示的 Instagram 應用程式 ID 及密鑰。Business Login for Instagram 在登入網址及權杖交換時,使用的是這組值,而非 Meta 應用程式本身的 ID 及密鑰。

easyCoexistence 會更新 Instagram 權杖嗎?

會。它會在權杖到期前更新存取權限,每 6 小時檢查一次各帳戶,並在需要重新連接時發送電郵。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期