此页面由 Cloud Translation API 翻译。

使用示例 API 代理

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。信息

前提条件

您需要 http://enterprise.apigee.com 的账号。您可以注册申请试用账号，网址为： http://accounts.apigee.com/accounts/sign_up.

如需使用示例，您还应该具备以下条件：

工具	说明
Git	相关示例位于 GitHub 上。如果您尚未安装 Git，请参阅 GitHub 的 Git 设置说明。如果您不想安装 Git，可以从 https://github.com/apigee/api-platform-samples 浏览文件并下载 ZIP 文件。
Python	必须安装 Python 才能运行 Apigee 部署工具。大多数 Linux 中都有 Python 环境中、安装了 XCode 的 Mac 上、安装了 Cygwin 的 Windows 计算机上，以及其他很多位置。要获取 Python，请参阅 Python 下载页面。
`curl`	示例设置脚本也使用 `curl`。确保已安装 `curl` （运行 `which curl` 命令以查看它是否在您的系统）。
`dos2unix`	如果您在 Windows 上运行 Cygwin，则可能还需要 `dos2unix` 实用程序。（您可以使用 Cygwin 安装程序来安装该实用程序。）

下载示例

如需获取示例文件，请使用 git clone，如以下示例所示：

git clone https://github.com/apigee/api-platform-samples.git

导入和部署示例 API 个指标

从命令行导入和部署示例：

下载示例后，转到 /setup 目录，如以下示例所示：
```
cd setup
```
在 /setup 目录中，找到文件 setenv.sh。
修改此文件即可设置您的组织，即与您的用户名关联的电子邮件地址，以及要在其中部署 API 代理的环境（生产或测试）。
修改 setenv.sh 后，请执行以下命令：
```
sh deploy_all.sh
```
此脚本会将所有 API 代理示例部署到您的组织。（此过程需要 3-4 minutes.)按照提示部署 API 产品、开发者和应用（用于 OAuth）。
部署脚本完成后，导航到 sample-proxies 目录。在 sample-proxies 目录中，每个示例代理会找到一个目录。在每个是一个 README.md 文件，其中包含有关运行该示例的信息，帮助您对示例稍作更改，进行部署，然后调用示例以查看您更改的效果： <ph type="x-smartling-placeholder">
- invoke.sh：执行此脚本以调用已部署的 API 版本代理。
- deploy.sh：执行此脚本以部署 API 代理，更改。

调用示例 API 代理

每个示例代理都有一个关联的 Shell 脚本，可用于调用 API 代理。

在 /sample-proxies/proxy_name 目录中，执行以下命令：以下：

sh invoke.sh

此操作会调用在贵组织的测试环境中运行的代理。

问题排查

如需了解问题排查信息，请参阅以下内容：

修改和重复使用示例 API 代理

示例代理的典型用途是修改、部署和调用。这样，你可以然后看看它们对响应消息的影响。

要修改示例 API 代理以指向其他后端服务，请将 XML 配置文件位于以下位置：

/apiproxy/targets/target_name.xml

例如，如需将 API 密钥示例指向您自己的后端服务，请找到以下文件：

/apikey/apiproxy/targets/default.xml

如果默认配置指向 http://mocktarget.apigee.net，例如：

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

您的后端服务可通过 http://api.myproject.com/ 访问，则您需要将配置修改为如下所示：

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://api.myproject.com/</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

保存更改后，请按照以下示例所示部署 API 代理：

sh deploy.sh

其他 API 代理可以采用相同的方式进行修改，以便使用 API 代理功能与现有的目标服务进行比较不过，在某些情况下，API 代理行为特定消息格式，因此代理可能需要其他配置更改。