JOYZL SCADA Scanner

接口

扫码端(JOYZL SCADA Scanner)支持配置工号校验扫码校验和批量提交接口，用于与其他系统交互。扫码端(JOYZL SCADA Scanner) 通过 HTTP POST 方式请求这些接口，数据接收方不应对扫码端接口设置登录和权限验证前提，对于安全方面的要求，可通过限制来源地址等其它方式实现。

工号校验

扫码端(JOYZL SCADA Scanner)每次读取到工号编码（条形码或二维码）时会立即请求 工号校验 接口验证工号是否有效员工，如果有效应返回员工名称。扫码端(JOYZL SCADA Scanner)以 POST 方式发送请求键值对参数，接收方验证编码后以 HTTP Status 200 OK 状态码返回有效，其它状态码均表示无效，响应内容为产品名称或无效原因。

校验方系统通常为 MES 或 ERP 系统，应确保快速校验并响应，如果长时间等待会降低扫码端操作人员效率，并引发用户抱怨。

请求示例

POST /scanner/check HTTP/1.1
ContentType: application/x-www-form-urlencoded
ContentLength: 30

employee=10001&equipment=GT001

示例中的 /scanner/check 表示接口提供方指定的路径。 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 状态码返回有效，其它状态码均表示无效，响应内容为产品名称或无效原因。

校验方系统通常为 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

产品名称

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 状态码表示成功，其它状态码均表示失败，没有响应内容。无论批量提交是否成功，编码会保存到本地文件，文件名为保存时扫入的批次号，默认为自动生成序号。

扫码批量提交过程：

扫描多个码，例如整批工件；
扫描保存码，与点击保存按钮作用相同；
扫描工单码；
批量提交；
保存本地。

请求示例

POST /scanner/post HTTP/1.1
Content-Type: application/json; charset=UTF-8
Content-Length: 2393

{
	// 工单码
	"Code": "JOYZL-20251217-D001",
	// 机台编号
	"Equipment": "GT001",
	// 员工编号
	"Employee": "10001",
	// 产品码数量
	"Size": 100,
	// 产品码集合
	"Codes": ["JOYZL-20251217-09876", "JOYZL-20251217-09877", ...]
}

响应示例

HTTP/1.1 200 OK
Content-Length: 0

HTTP/1.1 404 Not Found
Content-Length: 0