Instagram 存取權杖:長效權杖、60 天有效期與更新
Instagram 長效存取權杖有效期為 60 天,只要未過期且已滿 24 小時,即可再更新 60 天。使用 Instagram Login 登入後,會取得有效一小時的 Instagram 用戶短期存取權杖,應用程式的伺服器再將其換成長效權杖。
easyCoexistence 會為您保持 Instagram 權杖有效:在 60 天期限屆滿前更新存取權限,每 6 小時檢查帳戶,並在需要重新連接時電郵通知您,讓 Claude、ChatGPT 或您自己的程式碼都能以保持有效的權杖呼叫 Meta 官方 API。
從登入取得的短期 Instagram 用戶存取權杖有效時間。
更新後的長效權杖,由更新當日起計的有效時間。
Meta 更新長效權杖前,權杖須達到的最短時間。
每次登入的授權代碼可交換的次數;代碼有效期為 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 以秒為單位。
如何更新長效權杖?
呼叫 GET https://graph.instagram.com/refresh_access_token,並附上 grant_type=ig_refresh_token 及現有的長效權杖。回應中的權杖自更新當日起計有效 60 天。Meta 只會在以下三個條件同時成立時更新:
- 權杖為長效權杖,且已滿 24 小時。
- 權杖尚未過期。
- 帳戶擁有者已授予
instagram_business_basic權限。
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 及密鑰。
每個連接每月 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 監察
驗證日期