# API流（简易版）
API流（简易版）连接器当前仅包含"响应"一个执行动作和"当收到HTTP请求时"一个触发事件。
#### 连接参数
API流连接器无需认证，无连接参数。
#### 当收到HTTP请求时
用户可以通过对流进行编排，保存后会在该触发事件中生成请求URL发布到APIG网关中心，当该URL被调用时，该流会被触发执行，关闭后终止。用户可参考[表1]进行配置。
- 输入参数 用户配置响应触发事件，相关参数说明如[表1]所示。
   表1当收到HTTP请求时输入参数说明 
  | 参数       | 必填 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
  |:---|:---|:---|
  | API请求URL | 是  | 对外开放的请求URL，保存后生成URL。在域名右侧单击"![](https://support.huaweicloud.com/usermanual-mssi/zh-cn_image_0000001881974360.png) \> 管理域名"或在左侧导航选择"流编排 \> API流域名管理"，可以查看配置的域名，也可以对域名进行管理，域名管理的操作请参考[管理域名]。                                                                                                                                                                                                                                                                       |
  | API请求方式  | 是  | 指定该URL接口以哪种方式调用触发。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
  | API认证方式  | 否  | APIG注册接口的认证方式。 - IAM认证  - APP认证 当选择此值时，出现"支持简易认证"开关，如果打开开关，则在流保存后该执行动作会展示用户的AppCode信息。   - 无认证 当选择此值时，出现"访问控制"开关，如果打开开关，则可配置IP白名单列表。    |
  | API请求体架构 | 是  | 定义该URL接口传入的参数，参数格式以JsonSchema为准，当前支持参数位置位于query参数与Body参数。 说明： API请求体支持Json编辑器和控件两种模式。Josn编辑器模式下格式如[图1]所示。                                                                                                                                                                                                                                                                                              |
     
  图1请求体架构格式   
  ![](https://support.huaweicloud.com/usermanual-mssi/zh-cn_image_0000001882134308.png "点击放大")
  - 输出参数 该触发事件无输出参数说明。
    
   
 
#### 响应
"响应"执行动作需和API流的触发动作一起配合使用，用户通过此执行动作可以根据需要定制接口的响应信息。
其中响应体为Json格式的字符串，响应头为键值对（key=value）形式返回。
- 输入参数 用户配置响应执行动作，相关参数说明如[表2]所示。
   表2响应输入参数说明 
  | 参数      | 必须 | 说明                                            |
  |:---|:---|:---|
  | 状态码     | 是  | 选择状态码，有200、201、400、401、500、502。支持输入框和下拉框两种模式。 |
  | 响应体     | 否  | 设置响应体名称。                                      |
  | 响应头的key | 否  | 设置响应头的键，为数组模式。                                |
  | 响应头的值   | 否  | 设置响应头的数值，为数组模式。                               |
  | 响应头     | 否  | 设置响应头，需要选择数组类型的节点输出，为输入框模式。                   |
     
  - 输出参数 该执行动作无输出参数说明。
    
   
 
 #### 管理域名
对域名进行管理，实现任意域名生效就会运行流的目的。域名管理的操作请参考[表3]。
![](https://support.huaweicloud.com/usermanual-mssi/public_sys-resources/note_3.0-zh-cn.png)
需要绑定到API分组的域名需要满足以下条件：
- 已有独立域名。
- 需要绑定的域名已经cname解析到该分组的子域名b4dff2cc395e474eb0c837624c75eac6.apig.cn-north-7.huaweicloudapis.com，否则无法绑定。
- 需要绑定的域名已经完成ICP备案，否则无法绑定。
- 如果API分组中的API支持HTTS请求协议，则需要为独立域名添加SSL证书。
 
 表3管理域名的操作 
| 操作项      | 操作及说明                                                                                                                                                                                       |
|:---|:---|
| 绑定独立域名   | 单击"绑定独立域名"，输入域名，单击"确定"。创建成功的域名展示在列表中，最多支持创建5个独立域名。 域名的格式为*：abc*.com                                                                                           |
| 解除绑定独立域名 | 在独立域名列表中，在对应的"操作"列下，单击"解除绑定"，单击"确定"。                                                                                                                                                        |
| 添加SSL证书  | 当API分组中的API支持HTTS请求协议时，才有此操作。 在独立域名列表中，在对应的"操作"列下，单击"添加SSL证书"，输入已获取的证书名称、证书内容及密钥。单击"确定"。 证书内容及密钥使用的是pem编码，可以单击"样例"，查看样例。    |
| 查看证书     | 当API分组中的API支持HTTS请求协议时，才有此操作。 在独立域名列表中，在对应的"操作"列下，单击"查看证书"，可以查看证书详细信息。                                                                                         |
| 编辑SSL证书  | 当API分组中的API支持HTTS请求协议时，才有此操作。 在独立域名列表中，在对应的SSL证书列下，单击![](https://support.huaweicloud.com/usermanual-mssi/zh-cn_image_0000001881974372.png)，可以修改证书名称、证书内容及密码。 |
| 删除证书     | 当API分组中的API支持HTTS请求协议时，才有此操作。 在独立域名列表中，在对应的"操作"列下，单击"删除证书"，可以删除已添加的证书。                                                                                         |