编辑 | blame | 历史 | 原始文档

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

报文示例

{
  "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

报文示例

{
  "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

报文示例

{
  "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

报文示例

{
  "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 采集参数的时间

报文示例

{
  "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 包含具体的错误信息