一、说明
- 该接口主要应用于储位与电子标签的绑定，即通过PDA的【储位与PTL电子标签绑定】进行绑定时，程序是先初始化电子标签（即让所有标签亮灯），然后扫描储位，再拍灭标签，通过该接口，获取到拍灯的电子标签ID；（如硬件供应商不需要初始化标签，也能通过拍灯反馈ID，则第三方只需要提供该接口，不需要做接口处理）
- 该接口为第三方提供及维护，供WMS系统调用；
- 该接口使用前提：
- 储位与标签绑定关系需要用户手工绑定；（即硬件实施人员无法提供储位与标签ID的对应关系；）
- 绑定标签时，硬件供应商会提供初始化标签的功能，即让所有电子标签都亮灯，后续通过拍灯反馈当前绑定的标签ID；
二、参数说明
1.请求方式
| 请求方式 |
POST |
| 接口地址 |
http://第三方系统API/LightsInitialize |
| 格式 |
JSON |
| 编码类型 |
UTF-8 |
2.header参数
| Content-Type |
application/json |
3.请求参数
| 序号 |
字段 |
字段名 |
字段类型 |
长度 |
必填 |
说明 |
| 1 |
ref_id |
第三方系统标识 |
string |
10 |
是 |
自定义一个系统标识 |
| 2 |
task_id |
第三方任务单号 |
string |
100 |
是 |
任务唯一ID |
| 3 |
device_id |
控制器ID |
string |
30 |
|
“控制器ID”与“IP地址”任意栏位必须有值 |
| 4 |
ip |
IP地址 |
string |
80 |
|
“控制器ID”与“IP地址”任意栏位必须有值 |
| 5 |
port |
端口号 |
int |
|
|
|
4.返回参数
| 序号 |
字段 |
字段名 |
字段类型 |
长度 |
必填 |
说明 |
| 1 |
code |
处理结果 |
|
|
|
0视为成功，其他视为失败 |
| 2 |
message |
处理说明 |
|
|
|
|
| 3 |
task_id |
第三方任务单号 |
string |
100 |
|
任务唯一ID |
三、请求JSON示例
{
"ref_id": "AI-WMS PLUS",
"task_id": "935a4bfb-aad6-4ac0-9e97-ae18253b0adb",
"device_id": "SMT02-02",
"ip": "192.168.2.107",
"port": "0"
}
四、返回JSON示例
{
"code": 0,
"message": "",
"task_id": "935a4bfb-aad6-4ac0-9e97-ae18253b0adb"
}