好的,我已经将您提供的五个接口文档优化为更清晰、结构更统一的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 | 包含具体的错误信息 |