指南
集成指南
本页介绍了在将管理 Posts endpoint 集成到你的系统时需要了解的多种工具和关键概念。我们将本页分为几个不同的部分：
在介绍有助于你集成此 endpoint 的一些关键概念之前，建议先熟悉：
Postman 是一款非常适合用来测试 endpoint 的工具。每个 Postman 请求都包含所有路径参数和请求体参数，帮助你快速了解可用项。要进一步了解我们的 Postman 集合，请访问我们的 “Using Postman” 页面。
想用你偏好的编程语言，配合一些代码来对接此 endpoint 吗？我们在 GitHub 页面提供了多种代码示例，可作为你的起点。
利用我们社区的第三方库来帮助你快速入门。你可以通过查找相应的版本标签，找到适配 v2 endpoint 的库。
所有 X API v2 endpoint 都要求你使用一组凭证（也称为密钥和令牌）对请求进行身份验证。
这些特定的 endpoint 需要使用 OAuth 1.0a 用户上下文，也就是说，你必须使用一组 API Key 和用户 Access Tokens 才能成功发起请求。Access Tokens 必须与你所代表的该用户关联。如果你想为另一位用户生成一组 Access Tokens，对方必须通过 三方 OAuth 授权流程 授权或认证你的 App。
请注意，OAuth 1.0a 的使用可能较为复杂。如果你不熟悉此身份验证方法，建议使用一个 library、使用 Postman 等工具，或使用 OAuth 2.0 对请求进行身份验证。
OAuth 2.0 授权码模式（Authorization Code）配合 PKCE 可对应用的 scope，以及跨多设备的授权流程，提供更精细的控制。OAuth 2.0 允许你选择特定的细粒度 scope，从而代表用户获取相应的权限。
要在你的 App 中启用 OAuth 2.0，你需要在开发者门户的 App 设置中，进入该 App 的身份验证设置并将其启用。
要获取可用于 X API v2 endpoint 的一组身份验证凭证，您必须拥有一个开发者账户，在该账户内设置一个 Project，并在该 Project 内创建一个开发者 App。随后，您可以在您的开发者 App 中找到密钥和令牌。
每天都有成千上万的开发者向 X API 发起请求。为管理庞大的请求量，我们在每个 endpoint 上设置了请求速率限制，以限制你代表你的 App 或代表已认证用户所能发起的请求次数。
这些 endpoint 采用用户级别的请求速率限制，这意味着你所代表的已认证用户在任何开发者 App 中调用该 endpoint 的次数都有上限。对于 POST 方法，用户请求速率限制为每 15 分钟 200 次；对于 DELETE 方法，请求速率限制为每 15 分钟 50 次。此外，还存在一个每 3 小时 300 次请求的上限，其中包括通过 manage Posts 或 manage 转发 创建的 Post。
通过你的 App 以编程方式创建的任何 Post，其 metadata 中会将你的 App 名称和网站 URL 显示为来源标签。如果你更改了某个 X App 的使用场景，请务必在这些设置中更新该使用场景，以确保遵守开发者条款。
仅当你在个人资料设置中启用了地理位置功能时，才能为 Post 添加位置。如果未启用地理位置功能，你仍可在请求正文中添加位置参数，但该位置不会附加到你的 Post。为图片标记用户同理。如果你要标记的用户未启用照片标记功能，即使该 Post 已成功创建，他们的名字也不会显示在已标记用户的列表中。
目前，X API 的 v2 尚不支持完整的媒体上传。不过，你可以将之前已上传的媒体附加到 Post。你可以使用已通过 v1 媒体 endpoint 上传或 X Media Studio 上传的媒体 id。这些媒体 id 必须属于你本人或属于已认证的用户。
后续步骤
API 参考
⌘I