跳转到主要内容

​
开始使用“管理 Post”端点**

本快速入门指南将帮助你使用 Postman 向“管理 Post”端点发送你的第一个请求。 如果你希望查看不同语言的示例代码，请访问我们的 X API v2 sample code GitHub 代码库。
先决条件要完成本指南，你需要一组用于对请求进行认证的 keys and tokens。你可以按照以下步骤生成这些 keys 和 tokens：
  • 注册开发者账户 并获得批准。
  • 在开发者门户中创建一个 Project 以及关联的 developer App。
  • 前往你的应用的“Keys and tokens”页面生成所需的凭据。请确保将所有凭据保存在安全的位置。

​
构建管理 Post 请求的步骤

步骤一：选择工具或库 有多种工具、代码示例和库可用于向该端点发起请求，为了简化流程，这里我们将使用 Postman。 要将 X API v2 的 Postman 集合加载到你的环境中，请点击以下按钮：
在 Postman 中加载 X API v2 集合后，前往“Manage Posts”文件夹，选择“Create a Post”。   步骤二：为请求进行认证 要正确向 X API 发起请求，你需要确认自己拥有相应权限。对于 manage Posts 端点，必须使用 OAuth 1.0a 用户上下文 或 OAuth 2.0 授权码（PKCE） 对请求进行认证。 在本示例中，我们将使用 OAuth 1.0a 用户上下文。 你需要将密钥和令牌（具体包括 API Key、API Secret Key、OAuth 1.0a user Access Token 和 OAuth 1.0a user Access Token Secret）添加到 Postman。方法是选择名为“X API v2”的环境（位于 Postman 右上角），并将密钥和令牌填入“initial value”和“current value”字段（点击环境下拉菜单旁的眼睛图标）。 如果配置无误，这些变量会自动注入到请求的 authorization 选项卡中。 步骤三：指定 Post 的文本 使用此端点创建新 Post 时，Post 的文本或媒体是必填的请求体参数。 在 Postman 中，进入“Body”选项卡，将 Post 的文本作为 text 参数的值输入。此外，如果你希望添加投票、回复某个 Post 的 id，或设置回复权限等参数，也可以在此进行。你可以在我们的 API 参考指南 中了解详细可用项。
键值参数类型
textHello world!body
步骤四：选择并指定要返回的 fields 完成设置后，点击“Send”按钮，你将收到与以下示例类似的响应： 
{
  "data": {
    "id": "1445880548472328192",
    "text": "你好，世界！"
  }
}
如果返回的响应对象包含 id 和该 Post 的 text，则表示你已成功创建一个 Post。   步骤五：删除你的 Post 要删除一个 Post，请在已加载到 Postman 的 X API v2 集合中的“Manage Posts”文件夹内选择“Delete a Post”请求。此端点需要你要删除的 Post 的 ID。然后在“Params”选项卡中，将你要删除的 Post 的 ID 填入 id 列的值。  删除请求成功后，你将收到类似以下示例的响应： 
{
   "data": {
       "deleted" : true
   }
}
下一步 API 参考 获取支持 示例代码