使用Twitter API v2时遇403错误：应用已关联项目并设为生产环境

问题概述 #

调用https://api.twitter.com/2/tweets/search/stream/端点时返回403错误，错误提示应用未关联项目，但实际已完成项目关联、设置为生产环境，且拥有Elevated访问层级。错误详情如下：

{
    "client_id":"26948158",
    "detail":"When authenticating requests to the Twitter API v2 endpoints, you must use keys and tokens from a Twitter developer App that is attached to a Project. You can create a project via the developer portal.",
    "registration_url":"https://developer.twitter.com/en/docs/projects/overview",
    "title":"Client Forbidden",
    "required_enrollment":"Appropriate Level of API Access",
    "reason":"client-not-enrolled",
    "type":"https://api.twitter.com/2/problems/client-forbidden"
}

可能原因及解决方法 #

1. 认证凭证不匹配 #

• 代码中使用的API密钥、访问令牌可能属于未关联项目的旧应用，或是测试环境的凭证，而非当前关联项目的生产环境应用凭证。
• 解决：
  • 登录Twitter开发者门户，进入目标项目的生产应用页面，复制最新的API Key、API Secret、Access Token、Access Token Secret。
  • 替换代码中的旧凭证，确保无多余空格或字符。

2. 权限未同步生效 #

• 刚完成项目关联、升级访问层级后，权限可能需要几分钟到几小时才能完全同步到API服务器。
• 解决：
  • 等待1-2小时后重试请求。
  • 可在开发者门户重新生成应用凭证，触发权限同步。

3. 应用权限或端点权限未配置 #

• tweets/search/stream需要应用开启Read权限，且Elevated层级需包含该端点的访问权限。
• 解决：
  • 进入开发者门户的应用权限设置页，确认已开启Read and write或Read权限。
  • 检查项目的访问层级确实为Elevated（Basic层级下的100美元套餐对应Elevated访问）。

4. 认证方式错误 #

• 流式搜索端点仅支持OAuth 1.0a认证，使用Bearer Token会触发权限错误。
• 解决：
  • 修改请求逻辑，使用OAuth 1.0a签名方式，用API Key、Secret和Access Token、Secret生成请求签名，而非直接携带Bearer Token。

内容的提问来源于stack exchange，提问作者Martin Erlic