中国智造JOYZL SCADA Scanner
接口
扫码端(JOYZL SCADA Scanner)支持配置 工号校验， 工件校验 ， 提交换批 和， 报告故障 接口， 用于与其他系统（例如 MES 或 ERP 等管理系统）交互。 扫码端(JOYZL SCADA Scanner) 通过 HTTP POST 方式请求这些接口， 数据接收方不应对扫码端接口设置登录和权限验证前提， 对于安全方面的要求，可通过限制来源地址等其它方式实现。
工号校验
扫码端(JOYZL SCADA Scanner)每次读取到工号编码（条形码或二维码）时会立即请求 工号校验 接口验证工号是否有效员工，如果有效应返回员工名称。 扫码端(JOYZL SCADA Scanner)以 POST 方式发送请求键值对参数， 接收方验证编码后以 HTTP Status 200 OK 状态码返回成功， 响应内容为员工名称； 其它状态码均表示无效，响应内容为无效原因。
响应内容应为有效的 UTF-8 编码字符串，最多允许 64 个字符（不是字节数）， 如果超过最大长度，多余字符将被静默截断。
校验方系统通常为 MES 或 ERP 系统， 应确保快速校验并响应，如果长时间等待会降低扫码端操作效率，并引发用户抱怨。 工号无效的可能性有：工号不存在、员工状态冲突等。
未配置此接口时，不执行工号校验，只要工号符合设定字符长度，默认为员工有效。
请求示例
POST /scanner/employee HTTP/1.1
ContentType: application/x-www-form-urlencoded
ContentLength: 30
employee=10001&equipment=GT001
示例中的 /scanner/employee 表示接口提供方指定的路径。 employee为员工工号（必要）； equipment为机台编号（必要）。
响应示例
HTTP/1.1 200 OK
Content-Type: text/plain; charset=UTF-8
Content-Length: 4
小陈
HTTP/1.1 404 Not Found
Content-Type: text/plain; charset=UTF-8
Content-Length: 8
无效工号
工件校验
扫码端(JOYZL SCADA Scanner)每次读取到产品工件编码（条形码或二维码）时会立即请求 工件校验 接口验证编码是否有效，如果有效应返回对应的产品名称。 扫码端(JOYZL SCADA Scanner)以 POST 方式发送请求键值对参数， 接收方验证编码后以 HTTP Status 200 OK 状态码返回成功， 响应内容为产品名称； 其它状态码均表示无效，响应内容为无效原因。
响应内容应为有效的 UTF-8 编码字符串，最多允许 64 个字符（不是字节数）， 如果超过最大长度，多余字符将被静默截断。
校验方系统通常为 MES 或 ERP 系统， 应确保快速校验并响应， 如果长时间等待会降低扫码端操作效率，并引发用户抱怨。 用于加工环节扫码，产品编码无效的可能性有：系统中不存在、已入库、未出库等。
未配置此接口时，不执行工件编号校验，只要当前批次未重复，默认为工件有效。
请求示例
POST /scanner/check HTTP/1.1
ContentType: application/x-www-form-urlencoded
ContentLength: 56
code=JOYZL-20251217-09876&equipment=GT001&employee=10001
示例中的 /scanner/check 表示接口提供方指定的路径。 code为读取的产品或工件编码（必要）； equipment为机台编号（可选）； employee为员工工号（可选）。
响应示例
HTTP/1.1 200 OK
Content-Type: text/plain; charset=UTF-8
Content-Length: 8
JOYZL M02-01
HTTP/1.1 404 Not Found
Content-Type: text/plain; charset=UTF-8
Content-Length: 8
批次未登记
提交换批
扫码端(JOYZL SCADA Scanner)可将扫入的多个工件加工记录批量提交给管理系统。 当作业人员执行换批操作时，扫码端以 POST 方式发送 JSON 内容， 接收方收取成功后以 HTTP Status 200 OK 状态码表示成功， 其它状态码均表示失败，均无须提供任何响应内容。
接收方系统通常为 MES 或 ERP 系统。 如果提交失败，扫码端(JOYZL SCADA Scanner) 将稍后重试。
未配置此接口时，换批仅作本地处理。
请求示例
POST /scanner/post HTTP/1.1
Content-Type: application/json; charset=UTF-8
Content-Length: 282
{
// 批次编号（必要），由扫码端生成
"Number":"20260714-55756",
"Pieces":[
{
// 工件编码（必要）
"Code":"1234567890",
// 员工编号（可选）
"Employee":"1234",
// 工装编号（可选）
"Tooling": "MOLD001",
// 机台标识（必要）
"EquipmentId":317353539056580,
// 机台编号（必要）
"EquipmentNumber":"F3",
// 工件扫码时间（必要）
"Scan":"2026-07-14 15:29:32",
// 工件开始加工时间（可选）
"Begin":"2026-07-14 15:30:01",
// 工件结束加工时间（可选）
"End":"2026-07-14 15:32:30",
// 检验结果（可选）
"Verdict":{
"Name":"NORMAL",
"Text":"正常",
"Value":0
}
},
{
"Code":"0987654321",
"Employee":"1234",
"Tooling": "MOLD001",
"EquipmentId":317353539056580,
"EquipmentNumber":"F3",
"Scan":"2026-07-14 15:29:35",
"Begin":"2026-07-14 15:33:01",
"End":"2026-07-14 15:35:30",
"Verdict":{
"Name":"EX",
"Text":"异常",
"Value":0
}
}
]
}
工装编号(Tooling) 表示当前机台加工时所用的工具，例如：刀具、模具、砂轮、夹具或检具等。 可通过扫码端(JOYZL SCADA Scanner)扫描工具的条形码或二维码来登记， 如果有多个工具时，将由逗号作为分隔符拼接编号。
工件加工开始和结束时间(Begin, End) 依赖机台提供的作业状态信号，如果机台未能提供可用于数据采集监测的状态信号， 则没有工件加工开始和结束时间。
检验结果(Verdict) 的值有：NORMAL（正常）、OK（合格）、EX（异常）和 NG（不良），默认值为 NORMAL。 OK 和 NG 值在配合产品检验设备时才会出现，其结果值由检验设备提供的数据决定。 EX 值在扫码端(JOYZL SCADA Scanner)配置了加工过程监测功能时才会出现， 表示产品加工过程中监测到了异常。
响应示例
HTTP/1.1 200 OK
Content-Length: 0
HTTP/1.1 404 Not Found
Content-Length: 0
报告故障/恢复
扫码端(JOYZL SCADA Scanner)支持由作业人员报告机台故障（或恢复生产）给管理系统。 扫码端(JOYZL SCADA Scanner)以 POST 方式发送请求键值对参数， 接收方验证编码后以 HTTP Status 200 OK 状态码返回成功， 其它状态码均表示失败，均无须提供任何响应内容。
接收方系统通常为 MES 或 ERP 系统。 如果提交失败，扫码端(JOYZL SCADA Scanner) 将稍后重试。
未配置此接口时，报告故障仅做本地提示，此时将无法继续扫码，直至恢复生产。
请求示例
POST /scanner/report HTTP/1.1
ContentType: application/x-www-form-urlencoded
ContentLength: 27
equipment=GT001&state=FAULT
示例中的 /scanner/report 表示接口提供方指定的路径。 equipment为机台编号（必要）； state为机台状态（必要）， 值可为 FAULT 或 NORMAL 分别表示故障和正常。
响应示例
HTTP/1.1 200 OK
Content-Type: text/plain; charset=UTF-8
Content-Length: 0
HTTP/1.1 404 Not Found
Content-Type: text/plain; charset=UTF-8
Content-Length: 0
