智驱力社区

1. 添加工服库

接口功能描述：添加工服信息至底库，添加前判断限制最多1000个工服；
接口路径：[POST] http://云服务IP:9191/ks/proxy/work\_clothes；
请求参数说明；

参数名称	数据类型	是否必须	说明
device_ids	Array	是	设备ID数组
group_id	String	是	分组ID
external_id	String	否	外部id
name	String	是	名称
desc	String	否	简介

表. 请求参数

参数名称	数据类型	是否必须	说明
Authorization	String	是	‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

请求示例；

项目	详情
请求格式	JSON
报文内容	{ "device_ids": ["c92254f2-6124-4f9d-b3e2-feb0f33c1df8"], "group_id": "6593e3aa522e4b9ab8454f54", "external_id": "123", "name": "红色工服" }

响应参数说明；

参数名称	数据类型	说明
error_code	Int	返回响应码 0: 成功 -1: 客户端错误 -2: 服务端错误
message	String	返回响应信息
data	Object	以对象形式返回每个设备是否成功

响应示例。

项目	详情
报文格式	JSON
报文内容	{ "data": { "20e0c32b-f937-4cf2-9e8c-96d1e60e6519": { "id": "65ad08db522e4b09379b5ad5" "result": true, "reason": null } }, "error_code": 0, "message": { "zh": "新增工服成功！", "en": "Add workclothes successful!" } }

2. 修改工服库

接口功能描述：修改工服库信息；
接口路径：[PUT] http://云服务IP:9191/ks/proxy/work\_clothes；
请求参数说明；

参数名称	数据类型	是否必须	说明
device_ids	Array	是	设备ID数组
id	String	否	工服id
group_id	String	否	若同时存在group_id和external_id则忽略id
external_id	String	否
name	String	否	名称
desc	String	否	简介

表. 请求参数

参数名称	数据类型	是否必须	说明
Authorization	String	是	‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

请求示例；

项目	详情
请求格式	JSON
报文内容	{ "device_ids": ["c92254f2-6124-4f9d-b3e2-feb0f33c1df8"], "group_id": "6593e3aa522e4b9ab8454f54", "id": "6593e3aa522e4b9ab8454f54", "name": "蓝色工服" }

响应参数说明；

参数名称	数据类型	说明
error_code	Int	返回响应码 0: 成功 -1: 客户端错误 -2: 服务端错误
message	String	返回响应信息
data	Object	以对象形式返回每个设备是否成功

响应示例。

项目	详情
报文格式	JSON
报文内容	{ "data": { "20e0c32b-f937-4cf2-9e8c-96d1e60e6519": { "result": true, "reason": null } }, "error_code": 0, "message": { "zh": "更新工服成功！", "en": "Update workclothes successful!" } }

3. 查询工服库

接口功能描述：查询工服（按设备、名称、外部id、更新时间查询）；
接口路径：[GET] http://云服务IP:9191/ks/proxy/work\_clothes；
请求参数说明；

参数名称	数据类型	是否必须	说明
page	Int	是	页码
size	Int	是	每页数量
device_id	String	是	设备ID
group_id	String	否	分组ID
external_id	String	否	外部id
name	String	否	名称
start_time	Int	否	开始时间秒数
end_time	Int	否	结束时间秒数

表. 请求参数

参数名称	数据类型	是否必须	说明
Authorization	String	是	‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

请求示例；

项目	详情
请求格式	Query String
page	1
size	10
device_id	c92254f2-6124-4f9d-b3e2-feb0f33c1df8
group_id	6593e3aa522e4b9ab8454f54
name	红色工服
start_time	1704211200
end_time	1704384000

响应参数说明；

参数名称	数据类型	说明
error_code	Int	返回响应码 0: 成功 -1: 客户端错误 -2: 服务端错误
message	String	返回响应信息
data	Object	null

响应示例。

项目

详情

报文格式

JSON

报文内容

{
    "error_code": 0,
    "message": {
        "zh": "查询工服成功！",
        "en": "Query workclothes successful!"
    },
    "data": {
        "external_id ": "xxx ",
        "desc": "1234",
        "device_id": "df0fef91-a835-4197-bf59-c6ea18a492af",
        "id": "6593e3aa522e4b9ab8454f54",
        "image": "/9j/4AAQSkZJRg…",
        "name": "红色工服",
        "update_time": 1704351807
    }
}

4. 删除工服库

接口功能描述：删除工服；
接口路径：[DELETE] http://云服务IP:9191/ks/proxy/work\_clothes；
请求参数说明；

参数名称	数据类型	是否必须	说明
device_ids	Array	是	设备ID数组
ids	Array	否	工服id数组
group_id	String	否	分组ID
external_ids	Array	否	若存在group_id，或者同时存在group_id和external_ids，则忽略ids

表. 请求参数

参数名称	数据类型	是否必须	说明
Authorization	String	是	‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

请求示例；

项目	详情
请求格式	JSON
报文内容	{ "device_ids": ["c92254f2-6124-4f9d-b3e2-feb0f33c1df8"], "ids": ["6593e3aa522e4b9ab8454f54"] }

响应参数说明

参数名称	数据类型	说明
error_code	Int	返回响应码 0: 成功 -1: 客户端错误 -2: 服务端错误
message	String	返回响应信息
data	Object	以对象形式返回每个设备是否成功

响应示例

项目	详情
报文格式	JSON
报文内容	{ "data": { "20e0c32b-f937-4cf2-9e8c-96d1e60e6519": { "result": true, "reason": null } }, "error_code": 0, "message": { "zh": "删除工服成功！", "en": "Delete workclothes successful!" } }

5. 载入底库

接口功能描述：增加、修改、删除后需要调用一次使其生效，为避免影响检测，此接口不能频繁调用，最好是一批操作结束后通知用户手动调用；
接口路径：[POST] http://云服务IP:9191/ks/proxy/work\_clothes/load；
请求参数说明；

参数名称	数据类型	是否必须	说明
device_ids	Array	是	设备ID数组

表. 请求参数

参数名称	数据类型	是否必须	说明
Authorization	String	是	‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

请求示例；

项目	详情
请求格式	JSON
报文内容	{ "device_ids": ["c92254f2-6124-4f9d-b3e2-feb0f33c1df8"] }

响应参数说明；

参数名称	数据类型	说明
error_code	Int	返回响应码 -2: 服务端错误
message	String	返回响应信息
data	Object	以对象形式返回每个设备是否成功

响应示例。

项目	详情
报文格式	JSON
报文内容	{ "data": { "20e0c32b-f937-4cf2-9e8c-96d1e60e6519": { "result": true, "reason": null } }, "error_code": 0, "message": { "zh": "载入成功！", "en": "Successful loaded!" } }

6. 添加或修改工服图像

接口功能描述：添加或者修改工服图像；
接口路径：[PUT] http://云服务IP:9191/ks/proxy/work\_clothes/image；
请求参数说明；

参数名称	数据类型	是否必须	说明
device_ids	String	是	设备ID数组
id	String	否	工服id
group_id	String	否	若同时存在group_id和external_id则忽略id
external_id	String	否
image	File	是	工服图片

表. 请求参数

参数名称	数据类型	是否必须	说明
Authorization	String	是	‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

请求示例；

项目	详情
请求格式	Form Data
device_ids	["c92254f2-6124-4f9d-b3e2-feb0f33c1df8"]
id	6593e3aa522e4b9ab8454f54
image	(binary)

响应参数说明；

参数名称	数据类型	说明
error_code	Int	返回响应码 0: 成功 -1: 客户端错误 -2: 服务端错误
message	String	返回响应信息
data	Object	以对象形式返回每个设备是否成功

响应示例。

项目	详情
报文格式	JSON
报文内容	{ "data": { "20e0c32b-f937-4cf2-9e8c-96d1e60e6519": { "result": true, "reason": null } }, "error_code": 0, "message": { "zh": "更新工服成功！", "en": "Update workclothes successful!" } }

7. 下载模板

接口功能描述：下载模板；
接口路径：[GET] http://云服务IP:9191/ks/proxy/work\_clothes/xlsx；
请求参数说明；

参数名称	数据类型	是否必须	说明
group_id	String	是	分组ID
template	Bool	是	true

表. 请求参数

参数名称	数据类型	是否必须	说明
Authorization	String	是	‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

注意：前端调用时，还需指定responseType:'blob'。

请求示例；

项目	详情
请求格式	Query String
group_id	66cf14575dc58a095d35835a
template	true

响应参数说明；

参数名称	数据类型	说明
data	String	文件流

响应示例。

项目	详情
报文格式	文件流
报文内容	略

8. 批量导入

接口功能描述：批量导入；
接口路径：[POST] http://云服务IP:9191/ks/proxy/work\_clothes/xlsx；
请求参数说明；

参数名称	数据类型	是否必须	说明
device_id	String	是	设备ID数组
group_id	String	是	分组ID
package	file	是	文件

表. 请求参数

参数名称	数据类型	是否必须	说明
Authorization	String	是	‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

请求示例；

项目	详情
请求格式	Form Data
device_id	c92254f2-6124-4f9d-b3e2-feb0f33c1df8
group_id	66cf14575dc58a095d35835a
package	(binary)

响应参数说明；

参数名称	数据类型	说明
error_code	Int	返回响应码 0: 成功 -1: 客户端错误 -2: 服务端错误
message	String	返回响应信息
data	Object

响应示例。

项目	详情
报文格式	JSON
报文内容	{ "data": null, "error_code": 0, "message": { "zh": "导入工服底库成功！", "en": "Import work_clothes library successful!" } }

9. 批量导出

接口功能描述：批量导出工服底库；
接口路径：[GET] http://云服务IP:9191/ks/proxy/work\_clothes/xlsx；
请求参数说明；

参数名称	数据类型	是否必须	说明
group_id	String	是	分组ID

表. 请求参数

参数名称	数据类型	是否必须	说明
Authorization	String	是	‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

注意：前端调用时，还需指定responseType:'blob'。

请求示例；

项目	详情
请求格式	Query String
group_id	66cf14575dc58a095d35835a

响应参数说明；

参数名称	数据类型	说明
data	String	文件流

响应示例。

项目	详情
报文格式	文件流
报文内容	略

1. 添加工服库

2. 修改工服库

3. 查询工服库

4. 删除工服库

5. 载入底库

6. 添加或修改工服图像

7. 下载模板

8. 批量导入

9. 批量导出

底库管理-工服底库