向 API 发送请求

您可以通过 API 发送请求的选项有多种

• 开发人员和测试人员可能更喜欢使用 cURL，这是来自 http://curl.haxx.se/ 的命令行工具。

  使用 cURL，您可以发送 HTTP 请求并从命令行接收响应。

• 如果您喜欢使用更图形化的界面，Firefox 的 REST 客户端也适用于测试和尝试命令，请参阅 https://addons.mozilla.org/en-US/firefox/addon/restclient/。

• 您还可以下载并安装 rest-client，这是一个用于测试 RESTful Web 服务的 Java 应用程序，来自 https://github.com/wiztools/rest-client。

使用 cURL 发送 API 请求

cURL 是一种命令行工具，可在基于 UNIX® 系统的环境和 Apple Mac OS X® 系统中使用，并且可以下载到 Microsoft Windows® 上，用于与 REST 接口交互。有关 cURL 的更多信息，请访问 http://curl.haxx.se/。

cURL 使您能够从命令行或 shell 脚本中传输和接收 HTTP 请求和响应。因此，您可以在不使用客户端 API 的情况下直接使用 REST API。

以下 cURL 命令行选项在本指南中用于运行示例。

选项	描述
-d	将指定的数据在 POST 请求中发送到 HTTP 服务器。
-i	在输出中包含 HTTP 标头。
-H HEADER	在请求中指定 HTTP 标头。
-X	指定与 HTTP 服务器通信时使用的请求方法。指定请求代替默认方法，默认方法是 GET。例如，-X PUT 指定使用 PUT 请求方法。

注意 如果您拥有工具，可以使用以下选项格式化 cURL 的输出，来运行 cURL JSON 请求示例：<curl JSON 请求 示例> | python -mjson.tool。

将 cURL 请求示例复制并粘贴到终端窗口

要在 Linux 或 Mac 系统上运行本指南中显示的 cURL 请求示例，请执行以下操作

1. 将每个示例从本指南的 HTML 版本复制并粘贴到 ASCII 文本编辑器（例如，vi 或 TextEdit）中。您可以单击每个请求示例右侧的小文档图标来选择它。

2. 根据本指南中的详细说明，修改每个示例以使用您需要的帐户信息等。

3. 完成使用您的信息（例如，your_username 和 your_api_key）修改 cURL 请求示例的文本后，将其粘贴到您的终端窗口中。

4. 按 Enter 运行 cURL 命令。

   注意

   cURL 请求示例中作为 cURL 语法的回车符使用反斜杠 (\) 进行了转义，以避免过早终止命令。但是，您不应在命令内的 JSON 消息中转义回车符。

   提示

   如果您在复制和粘贴示例时遇到问题，请尝试在一行上键入整个示例，并删除所有反斜杠换行符。