好的,我已经将您提供的五个接口文档优化为更清晰、结构更统一的Markdown格式。主要优化点包括: 1. **统一格式**:将所有接口的说明、请求字段、响应字段等采用一致的标题层级和表格结构。 2. **修正错误**:修正了“托盘出站”接口名称和“适用工序”中的明显笔误。 3. **增强可读性**:使用加粗、代码块等Markdown元素,使关键信息和报文示例更突出。 4. **补充说明**:在报文示例中,将`body`部分用JSON代码块高亮显示,便于阅读。 --- ### **1.1. 托盘电芯绑定** #### **1.1.1. 触发条件** 1. 用于电芯码绑定托盘码。 #### **1.1.2. 接口说明** | 项目 | 内容 | | :----------- | :--------------------------------------- | | **接口名称** | 托盘电芯绑定(在制品&容器) | | **接口方式** | WebApi | | **请求方式** | POST | | **发送方** | EQP | | **接收方** | MES | | **接口地址** | `/EquipmentService/api/v1/BindContainer` | | **适用工序** | 电芯码绑定托盘码 | #### **1.1.3. 请求报文** **Header 字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :-------------- | :---------- | :------- | :---------- | | 1 | `Authorization` | MES认证信息 | STRING | 值由MES提供 | **Body 字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :----------------- | :----------------- | :------------------------------------- | :--------------------- | | 1 | `EquipmentCode` | 设备编码 | STRING | | | 2 | `ResourceCode` | 资源编码 | STRING | | | 3 | `LocalTime` | 调用本地时间 | DATETIME | | | 4 | `ContainerCode` | 托盘码 | STRING | | | 5 | `ContainerSfcList` | 绑定的电芯条码列表 | ARRAY OBJECT | | | 6 | `OperationType` | 操作类型 | 0-默认
1-进站
2-出站
3-进出站 | 换拘束托盘上传3,其余0 | **`ContainerSfcList` 数据集字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :--------- | :------- | :------- | :--- | | 1 | `Sfc` | 电芯码 | STRING | | | 2 | `Location` | 位置信息 | STRING | | **报文示例** ```json { "equipmentCode": "string", "resourceCode": "string", "localTime": "2024-03-01T03:12:29.265Z", "containerCode": "string", "containerSfcList": [ { "sfc": "string", "location": "string" } ] } ``` #### **1.1.4. 响应字段** | 字段 | 内容 | 数据类型 | 备注 | | :----- | :------- | :------- | :-------------------- | | `code` | 执行代码 | INT | 0: 成功
其他: 失败 | | `msg` | 返回信息 | STRING | 包含具体的错误信息 | --- ### **1.2. 托盘电芯解绑** #### **1.2.1. 触发条件** 1. 用于托盘码解绑电芯组。 #### **1.2.2. 接口说明** | 项目 | 内容 | | :----------- | :----------------------------------------- | | **接口名称** | 托盘电芯解绑(在制品&容器) | | **接口方式** | WebApi | | **请求方式** | POST | | **发送方** | EQP | | **接收方** | MES | | **接口地址** | `/EquipmentService/api/v1/UnBindContainer` | | **适用工序** | 托盘码解绑电芯组 | #### **1.2.3. 请求报文** **Header 字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :-------------- | :---------- | :------- | :---------- | | 1 | `Authorization` | MES认证信息 | STRING | 值由MES提供 | **Body 字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :-------------- | :----------- | :----------- | :--- | | 1 | `EquipmentCode` | 设备编码 | STRING | | | 2 | `ResourceCode` | 资源编码 | STRING | | | 3 | `LocalTime` | 调用本地时间 | DATETIME | | | 4 | `ContainCode` | 托盘码 | STRING | | | 5 | `SfcList` | 电芯条码组 | ARRAY STRING | | **报文示例** ```json { "equipmentCode": "string", "resourceCode": "string", "localTime": "2024-03-01T03:13:12.482Z", "containCode": "string", "sfcList": [ "string" ] } ``` #### **1.2.4. 响应字段** | 字段 | 内容 | 数据类型 | 备注 | | :----- | :------- | :------- | :-------------------- | | `code` | 执行代码 | INT | 0: 成功
其他: 失败 | | `msg` | 返回信息 | STRING | 包含具体的错误信息 | --- ### **1.3. 托盘NG电芯上报** #### **1.3.1. 触发条件** 1. 托盘存在NG条码,在拆盘或者OCV2, OCV3时,需要上报NG电芯。 #### **1.3.2. 接口说明** | 项目 | 内容 | | :----------- | :------------------------------------------- | | **接口名称** | 条码绑定(在制品&容器) | | **接口方式** | WebApi | | **请求方式** | POST | | **发送方** | EQP | | **接收方** | MES | | **接口地址** | `/EquipmentService/api/v1/ContainerNgReport` | | **适用工序** | 托盘NG电芯上报 | #### **1.3.3. 请求报文** **Header 字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :-------------- | :---------- | :------- | :---------- | | 1 | `Authorization` | MES认证信息 | STRING | 值由MES提供 | **Body 字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :-------------- | :------------------- | :----------- | :--- | | 1 | `EquipmentCode` | 设备编码 | STRING | | | 2 | `ResourceCode` | 资源编码 | STRING | | | 3 | `LocalTime` | 调用本地时间 | DATETIME | | | 4 | `ContainerCode` | 托盘码 | STRING | | | 5 | `NgSfcList` | 绑定NG的电芯条码列表 | ARRAY OBJECT | | **`NgSfcList` 数据集字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :---------------- | :------- | :------- | :--- | | 1 | `sfc` | 产品条码 | STRING | | | 2 | `ngCode` | NG代码 | STRING | | | 3 | `ngEquipmentCode` | NG设备 | STRING | | | 4 | `ngResourceCode` | NG资源 | STRING | | **报文示例** ```json { "equipmentCode": "string", "resourceCode": "string", "localTime": "2024-03-01T03:42:55.528Z", "containerCode": "string", "ngSfcList": [ "string" ] } ``` #### **1.3.4. 响应字段** | 字段 | 内容 | 数据类型 | 备注 | | :----- | :------- | :------- | :-------------------- | | `code` | 执行代码 | INT | 0: 成功
其他: 失败 | | `msg` | 返回信息 | STRING | 包含具体的错误信息 | --- ### **1.4. 托盘进站(容器进站)** #### **1.4.1. 触发条件** 1. 托盘进站。 #### **1.4.2. 接口说明** | 项目 | 内容 | | :----------- | :-------------------------------------------- | | **接口名称** | 托盘进站(容器进站) | | **接口方式** | WebApi | | **请求方式** | POST | | **发送方** | EQP | | **接收方** | MES | | **接口地址** | `/EquipmentService/api/v1/InboundInContainer` | | **适用工序** | 托盘进站 | #### **1.4.3. 请求报文** **Header 字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :-------------- | :---------- | :------- | :---------- | | 1 | `Authorization` | MES认证信息 | STRING | 值由MES提供 | **Body 字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :-------------- | :----------- | :------- | :--- | | 1 | `EquipmentCode` | 设备编码 | STRING | | | 2 | `ResourceCode` | 资源编码 | STRING | | | 3 | `LocalTime` | 调用本地时间 | DATETIME | | | 4 | `ContainerCode` | 托盘码 | STRING | | **报文示例** ```json { "equipmentCode": "string", "resourceCode": "string", "localTime": "2024-03-01T03:43:42.144Z", "containerCode": "string" } ``` #### **1.4.4. 响应字段** | 字段 | 内容 | 数据类型 | 备注 | | :----- | :------- | :------- | :-------------------- | | `code` | 执行代码 | INT | 0: 成功
其他: 失败 | | `msg` | 返回信息 | STRING | 包含具体的错误信息 | --- ### **1.5. 托盘出站(容器出站)** #### **1.5.1. 触发条件** 1. 托盘出站。 #### **1.5.2. 接口说明** | 项目 | 内容 | | :----------- | :--------------------------------------------- | | **接口名称** | 托盘出站(容器出站) | | **接口方式** | WebApi | | **请求方式** | POST | | **发送方** | EQP | | **接收方** | MES | | **接口地址** | `/EquipmentService/api/v1/OutboundInContainer` | | **适用工序** | 托盘出站 | #### **1.5.3. 请求报文** **Header 字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :-------------- | :---------- | :------- | :---------- | | 1 | `Authorization` | MES认证信息 | STRING | 值由MES提供 | **Body 字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :-------------- | :----------- | :----------- | :--- | | 1 | `EquipmentCode` | 设备编码 | STRING | | | 2 | `ResourceCode` | 资源编码 | STRING | | | 3 | `LocalTime` | 调用本地时间 | DATETIME | | | 4 | `ContainerCode` | 托盘码 | STRING | | | 5 | `ParamList` | 产品参数列表 | ARRAY OBJECT | | **`ParamList` 数据集字段** | 序号 | 字段 | 内容 | 数据类型 | 备注 | | :--- | :--------------- | :------- | :------- | :------------- | | 1 | `ParamCode` | 参数编码 | STRING | 工艺提供 | | 2 | `ParamValue` | 参数值 | STRING | | | 3 | `CollectionTime` | 时间戳 | DATETIME | 采集参数的时间 | **报文示例** ```json { "equipmentCode": "string", "resourceCode": "string", "localTime": "2024-03-01T03:43:42.144Z", "containerCode": "string", "paramList": [ { "paramCode": "string", "paramValue": "string", "collectionTime": "2024-03-01T03:43:42.144Z" } ] } ``` #### **1.5.4. 响应字段** | 字段 | 内容 | 数据类型 | 备注 | | :----- | :------- | :------- | :-------------------- | | `code` | 执行代码 | INT | 0: 成功
其他: 失败 | | `msg` | 返回信息 | STRING | 包含具体的错误信息 |