测试数据推送 API 对接规范

1.1 http请求头（Headers）

Content-Type:application/json

1.2 请求参数

参数结构说明：

参数采用URL字符串表示，?用于分割URL地址和参数，=用于连接关键字和属性值，&用于分割各关键字。URL字符串表现形式如下：
Url?key1=value1&key2=value2&key3=value3。

参数项：

参数名称	说明	数据类型	长度（字节）
model	机型号，英文字符串，用于区分不同的产品。	string	–
dut_order_code	涂鸦的生产工单号。	string	–
dut_number_name	DUT条码项名称。例如：SN、CMEI、MAC、IMEI。	string	–
dut_number_value	DUT条码项对应的值。	string	–
station	当前测试工站(工艺流程)。	string	–
fix_id	测试工位的识别码。	string	–
pc_mac	PC的mac地址(12位)。	string	–
is_pass	true/false，当前测试工站是否测试 pass。	bool	–
elapsed	测试总时长，精确到秒。	int	–
retry_cnt	尝试测了多少次。默认可为1。	int	–
is_misdetect	true/false，是否为误测结果。例如设置最大尝试测试次数为n次，在测试n次以内，测试结果为NG的，都作为误测结果上传；否则作为最终的测试结果。默认为false。	bool	–
defect_type_code	不良代码。不良代码由客户端测试工具开发者提供给MES厂商。	string	256
token	区分是否是同一次测试。建议以DUT端测试工具开始测试的时间戳为token。	string	–

1.3 http Body（raw）

1.3.1 云模组、成品(IPC\中控\网关\安防传感)测试工具对接

测试项参数名称	说明	数据类型	长度（字节）
name	测试项名称	string	–
value	测试结果值	string	–
elapsed	测试时长，单位：秒	int	–
result	测试结果，pass/ng	string	–

1.3.2 彩盒打印工具对接

测试项参数名称	说明	数据类型	长度（字节）
name	打印类型	string	–
Order	打印工单	string	–
DateTime	打印起始时间	string	–
SN	打印参数	string

1.3.3 机身普通打印工具对接

测试项参数名称	说明	数据类型	长度（字节）
name	打印类型	string	–
Order	打印工单	string	–
DateTime	打印时间	string	–
SN	打印数据	string

1.3.4 机身特殊打印工具对接

测试项参数名称	说明	数据类型	长度（字节）
name	打印类型	string	–
Order	打印工单	string	–
DateTime	打印时间	string	–
SN	打印数据	string
AuthSN	授权SN	string
Mac	Mac地址	string
UUID	Uuid信息	string

1.3.5 大包打印工具对接

测试项参数名称	说明	数据类型	长度（字节）
name	打印类型	string	–
Order	打印工单	string	–
DateTime	打印时间	string	–
PackageCode	大包编码	string
PackageNum	大包数量	string
PackageDatas	大包数据列表	List
SN	SN数据	string
Mac	Mac地址	string
UUID	Uuid信息	string

1.3.6 物料标签转码工具对接

测试项参数名称	说明	数据类型	备注
MaterialCode	物料编号	string	–
MaterialName	物料名称	string	–
SupplierId	供应商编号	string	–
MaterialSpecification	物料规格	string
CustomerMaterialCode	客户物料编号	string
Quantity	数量	Int
SerialNumber	流水号	Int
LotNumber	批号	string
Date	日期	string	yyyyMMdd

1.4 返回结果格式

编码格式：utf-8
内容格式：json
内容说明：

数据项名称	说明	数据类型	长度（字节）
resultCode	请求的结果码返回的结果码0：请求成功，0001或其他非0代码:错误，resultMsg给出详细错误信息，dut端需要显示resultMsg内容。	long	4
resultMsg	请求结果的附加提示信息。	string	–