35.网关异步分发插件 - 接入文档

## 1. 概述
网关异步请求分发插件支持以下两种使用场景：

- **单个系统到单个系统的请求** (1 -> 1)：以下简称为**异步接口**，适用于一个系统向另一个系统发起单点请求的场景。
- **单个系统到多个系统的请求** (1 -> N)：以下简称为**数据分发接口**，适用于一个系统向多个下游系统分发数据的场景。

#### 异步请求处理流程图 (待优化)
![](/media/202509/363a1f84713e4d20b421f037e438fd3c5598.png)

## 2. 接入说明

### 2.1 异步接口
- **网关配置**
  1. **提供必要信息**：调用方需将`源系统标识` `目标系统标识` `接口路径`提供给网关系统管理员，以便网关进行路由配置。
  2. **配置路由规则**：网关管理员根据提供的信息，在网关配置中心创建异步接口路由规则，确保请求能够正确转发至目标系统。

- **调用方代码改造**
  1. **构造请求参数**：按照网关定义的接口规范，构造请求参数，包括业务数据、系统标识等。
  2. **发起异步请求**：通过调用接口，将请求发送至网关，由网关进行异步转发处理。
  3. **参考文档**：https://doc.tqsys.cn/doc/339

### 2.2 数据分发接口
- **网关配置**
  1. **提供分发信息**：调用方需提供源系统标识`SSystem`以及需要分发到的多个目标系统的标识及路径信息
例如：`DSystem=EMS，path=/ems/api/saveData; DSystem=HR，path=/hr/api/saveData`。
提示：原PO接口，无需提供分发信息
  3. **配置分发规则**：网关管理员在网关配置中心创建数据分发规则，明确每个源系统请求的分发目标，确保数据能够准确分发至多个下游系统。

- **调用方代码改造**
  1. **设置目标系统标识**：在请求头中传入目标系统标识`(DSystem: TSG_ASYNC_DIVIDE)`，明确本次请求为数据分发请求。
  2. **构造分发数据**：根据业务需求，构造需要分发的数据内容，确保数据格式符合下游系统的接口要求。
  3. **发起分发请求**：源系统通过调用`网关分配的接口地址`发起数据分发请求。接口地址的生成规则如下：
  - 新接口：`由网关分配接口地址`
  - 原PO接口：原接口路径中的`/RESTAdapter`需替换为`/tsg`。
例如：原路径为`/RESTAdapter/plm/qm/MaintainMaterialData`，则网关分配的接口地址为`/tsg/plm/qm/MaintainMaterialData`

### 2.3 成功响应
```json
{
    "code": 200,
    "message": "Access to success! GUID: 1738914653336"
}
```

## 3. 配置示例
![](/media/202502/6c96450c94634a5aa49d477887068ce06931.png)

## 4. 常见问题解答
  1. **如何查询日志**：调用成功后，可使用返回消息中的GUID关键字，通过日志查询系统检索相关日志记录。
  2. **如何查看到下游系统的响应**：同样利用message中的GUID关键字查询日志，即可获取下游系统的响应信息。
  3. **请求处理失败后怎么办**： 源系统重新发起请求