接口描述

本接口(RunApi)用于调试 API 接口。用户在配置完成后可调用此接口进行调试,无需等到发布后走正式的调用流程。

输入参数

以下请求参数列表仅列出了接口请求参数,其它参数可参考 公共请求参数

参数名称 是否必选 类型 描述
serviceId String API 所在的服务唯一 ID。
apiId String API 唯一 ID。
requestHeader String API 的前端请求头部,是 json_dump 后的数据
requestQuery String API 的前端请求 Query,是 json_dump 后的数据
requestPath String API 的请求 Path,是 json_dump 后的数据
requestMethod String API 的请求方法。只支持 HEAD、GET、POST、PUT、PATCH 和 DELETE
requestBody String API 的请求 Body
requestBodyDict Dict API 的请求 Body,当 API 有设置 Body 类型入参时,用数组格式传入
contentType String 调试请求的内容类型。当前只支持 application/json 和 application/x-www-form-urlencoded,不传的话,默认为 application/x-www-form-urlencoded

输出参数

参数名称 类型 描述
code Int 公共错误码,0表示成功,其他值表示失败。详见错误码页面的 公共错误码
codeDesc String 业务侧错误码。成功时返回 Success,错误时返回具体业务错误原因
message String 模块错误信息描述,与接口相关
returnHeader String API 接口的响应头部
returnBody String API 接口的响应包体
returnCode Int API 接口的响应码
delay Int API 接口的响应延迟,单位 ms

示例

修改一个后端服务是 HTTP 的 API: 请求示例如下:

  1. https://apigateway.api.qcloud.com/v2/index.php?
  2. &<公共请求参数>
  3. &Action=RunApi
  4. &serviceId=service-XX
  5. &apiId=api-XX
  6. &requestHeader={"headerKey1":"headerValue1","headerKey2":"headerValue2"}
  7. &requestQuery={"queryKey1":"queryValue1","queryKey2":"queryValue2"}
  8. &requestPath={"pathKey1":"pathValue1","pathKey2":"pathValue2"}
  9. &requestMethod=GET
  10. &requestBody=abalabala
  11. &contentType=application/json

返回示例如下:

  1. {
  2. "code": "0",
  3. "message": "",
  4. "codeDesc": "Success",
  5. "returnHeader": "abcd",
  6. "returnBody": "efgh",
  7. "returnCode": 200,
  8. "delay": 300
  9. }