You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

Instagram access_token无效求助:获取账号图片API调用失败

解决Instagram API Access Token无效的问题

看起来你遇到的是Instagram API调用时常见的OAuthAccessTokenException错误,我帮你梳理几个核心原因和对应的排查修复步骤:

1. 你用的是已废弃的旧API端点

你调用的https://api.instagram.com/v1/users/...旧版Instagram API,这个版本早在2020年就停用了!现在Instagram的接口都统一迁移到了Facebook Graph API,旧的access_token自然无法在已废弃的旧端点上使用。

正确的获取用户媒体的Graph API端点应该是这样的:

GET https://graph.instagram.com/{instagram-user-id}/media?fields=id,media_url,caption&access_token=YOUR_VALID_ACCESS_TOKEN

2. Access Token的类型/权限不匹配

  • 如果你是获取个人Instagram账号的内容,需要确保生成token时申请了user_media权限;如果是商业/创作者账号,需要instagram_basic权限。
  • 短期access_token只有1小时有效期,如果你的token生成超过1小时,大概率已经过期了,需要换成60天有效期的长期token,或者重新生成新的短期token。

3. Token生成流程或应用设置有问题

  • 确认你是通过完整的OAuth授权流程获取的token:引导用户授权你的应用 → 获取授权code → 用code换取access_token,中间任何一步出错(比如code过期、重复使用)都会导致token无效。
  • 检查你的Facebook应用是否已经关联了目标Instagram账号:在Facebook开发者后台,进入应用的Instagram产品设置页面,确认已经绑定了你要访问的Instagram账号,否则token无法获取该账号的内容。
  • 如果你处于开发模式,只有添加到应用测试用户列表里的账号才能正常调用API,非测试用户的授权token会无效。

快速排查步骤

  • 用Facebook开发者工具里的Graph API调试器,输入你的access_token,查看token的有效期、权限、关联账号等信息,确认token本身是否有效。
  • 切换到正确的Graph API端点,用新的有效token重新发起请求。
  • 如果token过期,重新走一遍授权流程生成新的token,必要时换取长期token延长有效期。

内容的提问来源于stack exchange,提问作者Rohan Hapani

火山引擎 最新活动