Instagram 访问令牌:长期令牌、60 天有效期与刷新
Instagram 长期访问令牌有效期为 60 天,只要尚未过期且已满 24 小时,即可再刷新一次,获得另外 60 天的有效期。使用 Instagram Login 登录后,会得到一个有效期为一小时的 Instagram User 短期访问令牌,应用的服务器再将其换成长期令牌。
easyCoexistence 会为您保持 Instagram 令牌的有效性:在 60 天到期前续期访问权限,每 6 小时检查一次账户,并在需要重新连接时向您发送电子邮件。
登录后获得的 Instagram User 短期访问令牌的有效期。
刷新后的长期令牌的有效期,从刷新之日起计算。
Meta 允许刷新长期令牌前,该令牌的最短存在时间。
同一次登录的授权码可兑换的次数;该授权码有效期为 1 小时。
Instagram Login 使用哪种令牌?
Instagram User 访问令牌。它遵循 OAuth 2.0,限定于应用范围,包含应用、过期时间、账户的 Instagram 用户 ID 以及已授予的权限;每次调用 graph.instagram.com 时都需携带。Facebook Login 则使用 Facebook User 或 Page 访问令牌,Unified Login 使用 Business Integration System User 访问令牌。
应用如何获得长期令牌?
登录后在服务器端分两步完成交换。登录会以代码重定向,该代码有效期为一小时且只能使用一次。向 POST https://api.instagram.com/oauth/access_token 提交 Instagram 应用 ID 和密钥,即可换取短期令牌、该账户的应用范围用户 ID 以及已授予的权限。随后调用 GET https://graph.instagram.com/access_token,并传入 grant_type=ig_exchange_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 和密钥。
这样,Claude、ChatGPT 或您自己的代码便可使用持续有效的令牌调用 Meta 的官方 API。每个连接每月 US$ 9 起,连接越多价格越低,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
Instagram 访问令牌的有效期是多久?
短期令牌有效期为一小时。长期令牌有效期为 60 天,并可再刷新 60 天。
Instagram 授权码的有效期是多久?
有效期为一小时,且只能兑换一次;使用同一代码再次兑换会被拒绝。
Instagram Login 使用哪个应用 ID 和密钥?
使用 App Dashboard 的 Instagram 设置中显示的 Instagram 应用 ID 和密钥。Business Login for Instagram 在登录 URL 和令牌交换中使用这些值,而不是 Meta 应用本身的 ID 和密钥。
easyCoexistence 会刷新 Instagram 令牌吗?
会。它会在令牌过期前续期访问权限,每 6 小时检查一次每个账户,并在需要重新连接时发送电子邮件。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间