全部产品
云市场
云游戏

配置 API

更新时间:2020-06-04 14:50:39

注册 API 服务后,您需要进行相关配置才能使用 API 服务,尤其是 HTTP 类型的 API 服务。只有 API 服务状态为 开通 才能被调用。您需要手动开通 HTTP 类型的 API。

关于此任务

API 包括以下类型的参数配置:

  • 基础信息:API 名称、接口描述、接入系统等,不同类型的 API 服务还具备不同的属性。
  • 高级配置:签名校验、ETag 缓存、超时时间。
  • 缓存配置:缓存 API 的响应,减轻业务系统压力。
  • 参数设置:请求参数设置、响应设置等,此项配置为 HTTP 类型的 API 服务特有。

欲了解详细的参数介绍及配置规则,点击以上配置类型名称。

操作步骤

要配置 API,完成以下步骤:

  1. 登录 mPaaS 控制台,在左侧导航栏,点击 移动网关
  2. 在 API 列表中,选择要配置的 API 名称,点击操作列中的 配置,进入 API 详情页面。
  3. 在以下 API 不同的配置区域,点击 修改 进行相应参数的编辑。具体的配置方法,参见下方的 配置信息

    阿里云配置 API

  4. 点击 保存 完成配置。

配置信息

基础信息

根据不同类型的 API 服务,编辑相应的参数值:

  • HTTP API

    • API 名称:必填,该 API 的接口名称,方便后续维护。
    • 接口描述:选填,更详细的 API 描述。
    • 接入系统:必填,API 所属的业务系统。
    • 请求 Path:必填,URL Path,可使用 ${} 包含 path 参数,比如:/pets/${id}
    • 请求方式:必填,支持 GET、POST、PUT、DELETE 和 HEAD。
    • 报文编码:必填,UTF-8 或 GBK 格式。
  • MPC API

    • API 名称:必填,该 API 的接口名称,方便后续维护。
    • 接口描述:选填,更详细的 API 描述。
    • 接入系统:API 所属的业务系统。
    • 接口方法:API 服务端方法。
    • 接口名称:API 服务端接口。
  • Dubbo API

    • API 名称:必填,该 API 的接口名称,方便后续维护。
    • 接口描述:选填,更详细的 API 描述。
    • 接入系统:API 所属的业务系统。
    • 接口方法:API 服务端方法。
    • 接口名称:API 服务端接口。
  • TR API
    • API 名称:必填,该 API 的接口名称,方便后续维护。
    • 接口描述:选填,更详细的 API 描述。
    • 接入系统:API 所属的业务系统。
    • 接口方法:API 服务端方法。
    • 接口名称:API 服务端接口。

高级配置

  • 签名校验:选择是否开启签名校验。若开启,将对客户端请求的签名进行校验。
  • 超时时间:设置服务超时时间,单位毫秒(ms)。超时优先级:接口超时设置 > 系统超时设置 > 默认 3000 ms。
  • API 授权:选择 API 授权规则验证请求,通过则转发至后端系统,不通过则返回 2000 错误码。授权规则配置参见 API 授权

缓存配置

缓存 API 的响应,减轻业务系统压力。具体配置参见 API 缓存

参数设置

说明:此部分适用于 HTTP 类型的 API 服务。通过自动导入方式创建的 API 无需配置参数。

param

  • 请求参数设置

    • 参数名称:必填,参数的名称。
      说明:如果为 Path 参数,请保证名称与请求 Path 中的一致。例如,请求 Path 为 /pets/${id},此时参数名称应为 id
    • 参数位置:必填,参数位于 Path 或者 Query String 中。
    • 类型:必填,可选择的类型有 StringIntLongFloatDoubleBoolean
    • 默认值:选填,参数的默认值。
    • 描述:选填,参数描述。
  • 响应结果设置

    响应结果类型为基础类型或者自定义的数据模型。