Instagram Basic API长时访问令牌频繁过期问题咨询

我来帮你搞定这个Instagram长时令牌提前过期的麻烦，结合我做这类API集成的经验，给你梳理下排查方向和落地解决方案：

先排查令牌提前过期的核心原因 #

你说长时令牌接口返回成功但实际只有1小时有效期，大概率是这几个环节出了问题：

• 授权权限范围不对：确认你第一步授权时的scope确实是user_profile,user_media吗？如果漏了权限或者写错了，交换来的长时令牌会被限制有效期。
• 令牌交换参数出错：调用ig_exchange_token接口时，一定要检查这几个参数：
  • grant_type必须严格写ig_exchange_token，别和之前获取短时令牌的authorization_code搞混
  • client_secret要和你Instagram应用后台的完全一致，多一个空格或者字符都不行
  • 用来交换的access_token必须是刚拿到的有效短时令牌（短时令牌本身只有1小时有效期，要是你超时了才去交换，得到的长时令牌自然也会有问题）
• 应用状态限制：如果你的应用还处于开发模式，虽然官方说开发模式下长时令牌也是60天，但建议去应用后台确认下状态是否正常，有没有未完成的审核或者配置项。

确保生成有效60天长时令牌的正确步骤 #

再重新走一遍标准流程，确保每一步都没踩坑：

1. 获取授权码：

   https://api.instagram.com/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&scope=user_profile,user_media&response_type=code
   

   划重点：这里的redirect_uri必须和你应用后台配置的完全一致，包括http/https协议、域名、路径，哪怕多一个斜杠都会出问题。
2. 获取短时访问令牌：

   https://api.instagram.com/oauth/access_token?client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=authorization_code&redirect_uri=YOUR_REDIRECT_URI&code=AUTH_CODE
   

   注意这里的grant_type是authorization_code，别写错！
3. 交换为长时访问令牌：

   https://graph.instagram.com/access_token?grant_type=ig_exchange_token&client_secret=YOUR_CLIENT_SECRET&access_token=SHORT_LIVED_TOKEN
   

   调用后一定要检查返回的expires_in字段，正常应该是5184000（对应60天的秒数）。如果返回的是3600（1小时），说明交换肯定有问题，马上回头查参数。

服务器端自动刷新令牌的落地方案 #

拿到有效长时令牌后，要实现自动刷新，按这几步来：

• 选好刷新时机：别等令牌过期了才刷新，建议在过期前7天左右触发刷新，留足容错空间，避免网络波动等问题导致刷新失败。
• 刷新接口调用：还是用ig_exchange_token接口，把当前的长时令牌传进去，就能得到一个新的60天长时令牌：

  https://graph.instagram.com/access_token?grant_type=ig_exchange_token&client_secret=YOUR_CLIENT_SECRET&access_token=CURRENT_LONG_LIVED_TOKEN
  

  提醒一下：长时令牌最多能刷新2次，也就是总共可以用到180天，之后就需要用户重新授权了。
• 服务器端存储管理：把长时令牌和对应的过期时间（当前时间加上返回的expires_in秒数）存在你的服务器数据库里。每次请求Instagram API前，先检查令牌是否即将过期，要是快到期了就先刷新再用。
• 异常处理预案：如果刷新时返回令牌过期的错误，说明当前令牌已经失效，这时候得引导用户重新走授权流程获取新的令牌。

额外验证小技巧 #

• 每次获取或刷新令牌后，用FB Access Token Debug Tool验证下令牌的有效期和权限，确认是60天有效期且包含user_media权限。
• 去应用后台的OAuth Settings里再核对一遍Valid OAuth Redirect URIs，确保和你实际用的完全匹配。

内容的提问来源于stack exchange，提问作者Mohammed Ibrahim K. Bokhari