# 获取 Azure API 管理的 API 定义

从 API 合约 导出与 Azure API 管理兼容的 API 定义 JSON 文件。

* 您已安装 cURL。有关更多信息，请参阅 [cURL 文档](https://curl.haxx.se/docs/)。
* 您已在API 合约中创建了一个 API。

1. 打开命令行并输入以下命令以导出您的 API 定义：
   ```
   curl --header "Authorization:Bearer {userToken}" -X GET -o {outFile}.json https://apid.{region}.cloud.talend.com/api/v1/api-definitions/{api-id}?format=Swagger20Azure
   ```
2. 添加正确的参数：
   | 参数 | 描述 |
   | --- | --- |
   | {userToken} | 令牌生成自 Qlik Talend Cloud。 |
   | {outFile} | 您的 API 定义的路径和文件名。例如：contactsapi.json |
   | {region} | 您的 Qlik Talend Cloud 账户所在区域。该值可以是：<br><br><ul><li><span>us-west</span></li><li><span>us</span></li><li><span>eu</span></li><li><span>ap</span></li><li><span>au</span></li></ul><br><br>有关更多信息，请参阅[访问 Talend Cloud 应用程序](https://help.qlik.com/talend/en-US/installation-guide-windows/Cloud/talend-cloud-application-url)。 |
   | {api-id} | 要获取的 API 版本的 ID。要获取它，请在 API 合约 中打开您的 API，然后转到 设置 &gt; 管理 API，或者使用 GET 方法在 /api-definitions 端点上获取 API 定义及其 ID 的列表。 |
3. 执行命令。

您的 API 定义将导出为 JSON 文件，该文件与 Azure API 管理兼容，并保存到所选目录中。