跳转到主要内容

​
开始使用管理 Post 的 endpoints**

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

​
构建 manage Posts 请求的步骤

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