调试API_API网关 APIG_快速入门_开放API

操作场景

API创建后需要验证服务是否正常，管理控制台提供调试功能，您可以添加HTTP头部参数与body体参数，调试API接口。

• 后端路径中含有环境变量的API，不支持调试。
• API绑定签名密钥时，不支持调试。
• 如果API已绑定流控策略，在调试API时，流控策略无效。

前提条件

• 已创建API分组和分组内的API。
• 已搭建完成后端服务。

操作步骤

1. 登录管理控制台。
2. 在管理控制台左上角单击，选择区域。
3. 在服务列表中，选择“应用服务 > API网关”，进入API网关服务管理页面。
4. 在左侧选择您的API版本，单击并进入到对应版本的API开发与调用管理页面。

   “共享版”指直接创建并管理API，如涉及到费用，以API调用次数计费。

   “专享版”指在API专享版实例中创建并管理API，如涉及到费用，按实例运行时间计费。

5. 单击“开放API > API管理”，进入到API管理信息页面。
6. 通过以下任意一种方法，进入API调试页面。
   • 在待调试的API所在行，单击“更多 > 调试”。
   • 单击“API名称”，进入API详情页面。在右上角单击“调试”。
   图1 调试界面
   

   左侧为API请求参数配置区域，参数说明如表1所示。右侧为API发送的请求信息和API请求调用后的返回结果回显。

   表1 调试API

   参数名称	说明
   协议	仅在API请求的“请求协议”为“HTTP&HTTPS”时，支持修改。
   方法	仅在API请求的“Method”定义为“ANY”时，支持修改。
   后缀	仅在API请求的“匹配模式”为“前缀模式”时，支持自定义路径。
   路径	仅在API请求的“请求Path”中存在“{}”时，支持修改。
   请求头	HTTP Headers的参数与参数值。
   查询参数	Query的参数与参数值。
   请求体	仅在API请求的“Method”定义为“PATCH”/“POST”/“PUT”时，支持修改。

   

   不同类型的请求，调试界面展现的信息项有差异。

7. 添加请求参数后，单击“发送请求”。

   右侧返回结果回显区域打印API调用的Response信息。

   • 调用成功时，返回HTTP状态码为“200”和Response信息。
   • 调试失败时，返回HTTP状态码为4xx或5xx，具体错误信息请参见错误码。

8. 您可以通过调整请求参数与参数值，发送不同的请求，验证API服务。
   

   如果需要修改API参数，请在右上角单击“编辑”，进入API编辑页面。

后续操作

API调试成功后，您可以将API发布到环境，以便API调用者调用。或者出于API的安全性考虑，为API创建如下策略：

• 创建流控策略并绑定到API
• 创建访问控制策略
• 创建并使用签名密钥