概述

​

开始使用置顶 List 端点组

本快速概览将帮助你使用 Postman 向置顶的 List 端点发出第一个请求。

如果你想查看不同编程语言的示例代码，请访问我们的 X API v2 sample code GitHub 代码库。

​

前提条件

要完成本指南，你需要一组用于对请求进行认证的 keys and tokens。你可以按照以下步骤生成这些 keys 和 tokens：

• 注册开发者账号 并通过审批。
• 在开发者门户中创建一个 Project 和关联的 developer App。
• 前往你的应用的“Keys and tokens”页面生成所需凭证。请务必将所有凭证保存在安全位置。

加载 X API v2 的 Postman 集合

要将 X API v2 的 Postman 集合加载到你的工作区，请点击以下按钮：

将 X API v2 添加到 Postman

 

​

为你的请求进行认证

要成功调用 lookup 端点，你可以使用 OAuth 1.0a 用户上下文、OAuth 2.0 App-Only，或 OAuth 2.0 授权码（PKCE）。不过，对于 manage 端点，你只能使用 OAuth 1.0a 用户上下文或 OAuth 2.0 授权码（PKCE）进行认证。

在使用 Postman 时，只要你正确设置了环境，默认的认证密钥和令牌会自动填充到请求中。

你可以在 Postman 右上角选择名为“X API v2”的环境，并通过点击环境下拉菜单旁的“眼睛”图标，将你的密钥和令牌添加到 “initial value” 和 “current value” 字段中。所需密钥包括：

• API Key（亦称 Consumer Key）
• API Secret Key（亦称 Consumer Secret）
• OAuth 1.0a 用户 Access Token
• OAuth 1.0a 用户 Access Token Secret
• OAuth 2.0 App Access Token
• OAuth 2.0 Client Key（仅当你在应用的设置中配置了 OAuth 2.0 用户认证设置时可用）
• OAuth 2.0 Client Secret（仅当你在应用的设置中配置了 OAuth 2.0 用户认证设置时可用）