Skip to main content

如何使用 Postman

您可以使用 Postman 测试 Server API V3。

先决条件:

  • 您必须已安装 Postman。可在 https://www.postman.com/downloads/ 下载 Postman。安装并创建一个账户。确保您使用的是 Postman 桌面版本,而不是浏览器版本。确认您的邮件地址后,您可能最终会使用浏览器版本。

    注意

    Web 版 Postman 无法访问大部分客户的 API,原因在于客户的 API 受防火墙保护。这样一来,Web 版 Postman 就无法进行访问。

  • 您必须具有 API 验证序号和 API 密钥才能在 Postman 中测试 Server API。如需了解详情,请前往 用户角色和权限 帮助页。

将 API 添加到 Postman

要测试 Server API,请将其导入 Postman。

获取文档和令牌 URL

  1. 要获取文档 URL,请前往 Server UI,选择右上角的 问号图标 ,然后选择 API 文档 。这将打开 API V3 Swagger 页面。

    api_postman_getdetails0.png
  2. 获取 文档 URL 。请注意“webapi”后有双反斜杠。

    注意

    只有 Server 与 Postman 在同一主机上运行时,localhost 才能工作。否则(如在远程工作站运行),您必须使用主机名或 IP 地址。

    api_address_docu.png

    示例: http://localhost/webapi//swagger/docs/3

  3. 查看任意 API 端点。

  4. 选择右侧的 红色感叹号 开始执行验证过程。

  5. 复制令牌 URL。示例: http://localhost/webapi/oauth2/token

    api_copy_tokenURL.png

在 Postman 中加载 Swagger 文档

  1. 在 Postman 中,转至 Collections(集合) 选项卡。

  2. 选择 导入

  3. 输入 获取文档和令牌 URL 中所述的文档 URL。

  4. 选择 导入

    api_swagger_load_01.png
    api_swagger_load_02.png

    这会将 Alteryx Server API V3 添加至左侧的“Collections(集合)”选项卡下。

创建要在 API 调用中使用的 OAuth2 访问令牌

为了能够发送请求,您必须在 Postman 中设置授权并创建一个 OAuth2 访问令牌。

  1. 找到 Collections(集合) ,并选择 Alteryx Server API V3

  2. 选择 Authorization(授权) 选项卡。

  3. Type(类型) 选择 OAuth 2.0

    api_postman_auth.png
  4. 向下滚动授权页面至 Configure New Token(配置新令牌) 部分。

  5. 将令牌名称设置为 YOUR_TOKEN_NAME

    注意

    系统不提供 YOUR_TOKEN_NAME 的输入。您可以输入希望使用的任意 令牌名称

  6. Grant Type(授权类型) 中选择 Client Credentials(客户端凭证)

  7. Access Token URL(访问令牌 URL) 设置为 TOKEN_URL_FOUND_ABOVE

  8. Client ID(客户端 Id) 设置为 YOUR_API_ACCESS_KEY

  9. Client Secret(客户端密钥) 设置为 YOUR_API_ACCESS_SECRET

  10. Client Authentication(客户端身份验证) 中,选择 Send as Basic Auth header(作为 Basic Auth 响应头发送)

  11. 选择 Get New Access Token(获取新访问令牌) 按钮。

  12. 选择 Proceed(继续)

  13. 选择 Use Token(使用令牌) 按钮。

    api_postman_auth2.png

如果访问令牌过期,请重新创建

一段时间后,您的原始令牌将过期,访问 API 时会收到“401-身份验证失败”错误。要重新创建令牌,请执行以下操作:

  1. Collections(集合) 选项卡上选择 Alteryx Server API V3

  2. Available Tokens(可用令牌) 下拉菜单中选择 Manage Tokens(管理令牌)

  3. 选择过期令牌(令牌上将有删除线贯穿)。

  4. 删除过期令牌。

  5. 参照 创建要在 API 调用中使用的 OAuth2 访问令牌 所述创建新令牌。

在 Postman 中使用 API

以下示例演示了相关情形下的通用 API 模式

在以下示例中,我们将使用 API 从 Server 的用户列表中检索用户 ID。然后,我们将使用该用户 ID 获取用户的详细信息。最后,我们将使用用户数据对用户记录进行更新。

为简单起见,我们将在此示例中更改用户的名字。实际操作时,最好使用 Server UI 执行此操作。

api_postman_search1.png
api_postman_search2.png
api_postman_search3.png
  1. 导航至 GET v3/users/

  2. 取消选择全部八个 查询参数 (要搜索用户集合,请选择一个或多个参数并输入搜索值)。

  3. 选择 Auth(身份验证) 选项卡。

  4. Type(类型) 设置为 OAuth 2.0

  5. 选择您在上述步骤创建的令牌。

  6. 选择 Send(发送)

  7. 在屏幕底部查看结果。

  8. 复制要在下一步骤中使用的用户 ID。

根据上述示例或直接在 Server UI 中获取用户 ID(查看用户时从 URL 复制)。

api_postman_getdetails1.png
api_postman_getdetails2.png
api_postman_getdetails3.png
  1. 导航至 GET v3/users/{id} 端点。

  2. 输入 UserID 作为 id param 的值。

  3. 如上一步骤所示,在 Authorization(授权) 选项卡中选择您的令牌。

  4. 选择 Send(发送)

  5. 从屏幕底部的 Body(响应体) 部分复制整个 JSON 对象(包括前导和尾部花括号)以在下一步骤中使用。

在上一步中获取用户的详细信息(JSON 对象)以用于此步骤。

api_postman_updatedetails1.png
api_postman_updatedetails2.png
api_postman_updatedetails3.png
  1. 导航至 PUT v3/users/{id} 端点。

  2. 输入 UserID 作为 id param 的值。

  3. 如上一步骤所示,在 Auth(身份验证) 选项卡中选择令牌。

  4. 选择 Headers(响应头) 选项卡。

  5. 取消选中 Content-type(内容类型) 复选框,因为您要发送的并不是表单数据,而是 JSON 对象。

  6. 选择 Body(响应体) 选项卡。

  7. 选择 raw

  8. 选择 JSON

  9. 粘贴用户数据的 JSON 对象。

  10. 编辑要更改的数据。

  11. 选择 Send(发送)

  12. 请注意返回代码 200 OK。