跳转到主要内容

介绍

Project 让你可根据计划如何使用 X API 来组织工作,从而有效管理对 API 的访问并监控使用情况。每个 Project 可包含一个或多个应用,具体取决于你的访问级别(本页后文说明)。你将使用这些应用生成认证凭据,例如 API Keys 和 Secrets、用户Access Tokens以及App Access Token 你可以使用任何应用中的这些密钥和令牌访问 X API 或 X Ads API(使用 Ads API 需要申请额外访问权限),但要调用 X API v2 的 endpoints,必须使用与某个 Project 关联的应用所生成的密钥和令牌。 如果你拥有开发者账号,可在开发者门户的 Projects & Apps 页面查看与管理你的 Project。若尚未拥有账号,请注册

项目与 X API 访问级别

目前,在项目级别适用的访问层级共有 4 种:
  • 免费
  • 基础
  • 专业版
  • 企业版
若要了解每个访问级别提供的详细内容,请访问 关于 X API 页面。 你在免费、基础或专业版这三个级别中只能拥有一个项目。 我们将在此为你介绍一些项目特定的差异:

免费

此访问层级面向已注册开发者账号的用户。 该 Project 中的应用数量:1 Tweet 使用上限:每月 1,500 条 Tweet 认证方式:

基础

此访问层级适用于在开发者门户订阅基础访问的所有用户。 该 Project 下的应用数量:2 Tweet 使用上限:每月 10,000 条 Tweet 认证方式:

Pro

该访问层级适用于通过开发者门户订阅了 Pro 访问的用户。 该 Project 下的应用数量:3 Tweet 使用上限:每月 100 万条 Tweet 认证方式:

企业版

此访问层级适用于已申请企业版、经我们团队批准,并通过 X 客户经理签署按月自动续约合同的用户。在此申请 该 Project 下的应用数量:3+ Tweet 使用上限:每月 5,000 万条以上 Tweet 认证方式:

Tweet 上限与项目

Tweet 消耗上限适用于项目级,因而会在每个自然月内有效限制你可从特定 X API v2 端点检索的 Tweet 数量。 了解更多:Tweet 上限

配置项目

创建项目

要创建项目,请在你的仪表板或开发者门户中的Projects & Apps页面点击“New Project”。只有当你尚未创建任何项目时,才会看到此选项。系统会提示你填写项目名称、描述和使用场景。你还需要创建一个新的应用,或连接一个现有的独立版应用。

为你的项目创建或连接应用

如果你的项目尚未包含应用,你可以在仪表板中点击项目名称来添加一个。随后,你可以创建新的应用,或选择现有的独立版应用并将其连接到你的项目。应用是你生成本指南开头所列认证密钥和令牌的入口。

编辑 Project

要编辑 Project,请在开发者门户的仪表板或 Projects & Apps 页面中点击你的 Project 名称。随后你将看到该 Project 的详细信息,并可选择“编辑”进行更改。

独立版应用

独立版应用是存在于 Project 结构之外的应用。与这些独立版应用关联的认证凭据可用于成功请求 X 的 API 标准版 v1.1、premium v1.1、enterprise,或 X Ads API。除非将其连接到 Project,否则独立版应用在尝试请求 X API v2 端点时会失败。 如果你在 2020 年 8 月之前创建了应用,它们会显示在开发者门户 Projects & Apps 下的“Standalone Apps”部分。你的应用总数将被限制为 10 个,其中包括已连接到你 Project 的应用。 如果你属于团队账号,你会在 Standalone Apps 下看到你拥有的应用。如果某位队友拥有一个属于 Project 的应用,你将能看到该应用的名称和所有者信息,但无法更改其设置、访问其密钥和令牌,或重新生成其密钥和令牌。若需进行任何更改,请联系该应用的所有者。