配置 API - 移动开发平台 mPaaS

关于此任务

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

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

要配置 API，完成以下步骤：

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

网关支持为所有请求添加或者删除 header。在 header 设置 区域，点击修改进入打开编辑模式后，即可通过点击 Add 可以添加一条规则。每条规则包含位置、类型、headerKey、value 和操作五个属性。

header

位置：可选 request header 或 response header。
- 添加 request header 会自动在 request 中增加 header，业务可以通过 MobileRpcHolder 获取该 header。
- 添加 response header 会自动在 response 中增加 header，客户端可以从 response 中获取该 header。
类型：可选增加（add）或删除（delete）。
- 增加（add）：添加一个新的 header，如果原请求已有 header，则会被新增的 header 覆盖。
- 删除（delete）：删除一个 header。删除 header 可以配置 value 也可以不配置。如果配置 value，那么只有在 vulue 匹配时才会删除。
headerKey：headerKey 可以为符合 RFC 定义的任意字符串，除 http 协议中的特有 header 之外，比如 host、content-Type 等；也不可以是 mpaasgw 中特有 header，比如 operation-Type 等。
value：可以为任意字符串。
操作：删除当前 header 规则。
说明：定义 HTTP header 时，请不要使用下划线“_”。

限流配置包括限流模式、限流值、限流响应：

限流模式
- 关闭：不限制 API 调用。
- 拦截：当调用频次超过限流值，拦截请求。
限流值
根据业务需求设置合理的限流阈值（单位：秒）。限流模式为拦截且超过此值时，请求会被限流。
限流响应
限流默认的响应为：{"resultStatus":1002,"tips":"顾客太多，客官请稍候"}
如需定制限流响应，使用如下格式：
```
     
        {
            "result": "==此处为定制响应内容,请填写==",
            "tips": "ok",
            "resultStatus": 1000
        }
     
```
其中，
- result 为定制的响应数据，JSON 格式。只有 resultStatus 为 1000 时，客户端才会取此字段处理。
- tips 为定制的限流提示。若 resultStatus 为 1002，会取此字段提示用户。
- resultStatus 为限流返回的结果码，具体含义请参见网关结果码。

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

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

param