帝可得

点位管理

查询区域列表

基本信息

Path： /manage/region/list

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
pageNum	是	1	当前页
pageSize	是	10	每页个数
name	否	海淀区	区域名称

返回数据

名称	类型	是否必须	默认值	备注	其他信息
total	number	必须			mock: 3
rows	object []	必须			item 类型: object
├─ remark	string	必须		备注说明
├─ id	number	必须		区域ID
├─ name	string	必须		区域名称
├─ nodeCount	number	必须		点位数量
code	number	必须			mock: 200
msg	string	必须			mock: 查询成功

查询点位列表

基本信息

Path： /manage/node/list

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
pageNum	是	1	当前页
pageSize	是	10	每页个数
name	否		点位名称
regionId	否		区域ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
total	number	必须			mock: 10
rows	object []	必须			item 类型: object
├─ id	number	必须		点位ID
├─ name	string	必须		点位名称
├─ addr	string	必须		点位地址
├─ areaCode	string	必须		区域编号
├─ regionId	number	必须		区域ID
├─ regionName	string	必须		区域名称
├─ businessId	number	必须		商圈ID
├─ ownerId	number	必须		合作商ID
├─ ownerName	string	必须		合作商名称
├─ vmCount	number	必须		设备数量
code	number	必须			mock: 查询成功
msg	string	必须			mock: 200

重置合作商密码

基本信息

Path： /manage/partner/resetPwd/:id

Method： GET

接口描述：

请求参数

路径参数

参数名称	示例	备注
id	1	合作商ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
msg	string	必须		返回内容	mock: 操作成功
code	number	必须		状态码	mock: 200

设备管理

查询设备类型

基本信息

Path： /manage/vmType/:id

Method： GET

接口描述：

请求参数

路径参数

参数名称	示例	备注
id		设备类型id

返回数据

名称	类型	是否必须	默认值	备注	其他信息
msg	string	非必须
code	number	非必须
data	object	非必须
├─ id	number	非必须
├─ name	string	非必须
├─ model	string	非必须
├─ image	string	非必须
├─ vmRow	number	非必须		货道行数
├─ vmCol	number	非必须		货道列数
├─ channelMaxCapacity	number	非必须		货道容量（个）

根据售货机编号查询货道列表

基本信息

Path： /manage/channel/list/:innerCode

Method： GET

接口描述：

请求参数

路径参数

参数名称	示例	备注
innerCode	A1000001	设备编号

返回数据

名称	类型	是否必须	默认值	备注	其他信息
msg	string	必须		返回内容	mock: 操作成功
code	number	必须		状态码	mock: 200
data	object []	必须			item 类型: object
├─ id	number	必须		货道ID
├─ channelCode	string	必须		货道编号
├─ skuId	number	必须		商品ID
├─ innerCode	string	必须		设备编号
├─ maxCapacity	number	必须		最大容量
├─ currentCapacity	number	必须		当前容量
├─ sku	object	必须		商品
├─ skuId	number	非必须		商品ID
├─ skuName	string	非必须		商品名称
├─ skuImage	string	非必须		商品图片

货道关联商品

基本信息

Path： /manage/channel/config

Method： PUT

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/json	是

Body

名称	类型	是否必须	默认值	备注	其他信息
innerCode	string	必须		设备号
channelList	object []	必须		货道配置集合	item 类型: object
├─ innerCode	string	必须		设备编号
├─ channelCode	string	必须		货道编号
├─ skuId	number	必须		商品ID

返回数据

名称	类型	是否必须	默认值	备注	其他信息
msg	string	必须			mock: 操作成功
code	number	必须			mock: 200

工单管理

取消工单

基本信息

Path： /manage/task/cancel

Method： PUT

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/json	是

Body

名称	类型	是否必须	默认值	备注	其他信息
taskId	number	必须		工单Id
desc	string	必须		拒绝理由

返回数据

名称	类型	是否必须	默认值	备注	其他信息
msg	string	必须
code	number	必须

新增工单

基本信息

Path： /manage/task

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/json	是

Body

名称	类型	是否必须	默认值	备注	其他信息
createType	number	必须		创建类型，传1
innerCode	string	必须		设备编号
userId	number	必须		执行人Id
assignorId	number	非必须		指派人Id
productTypeId	number	必须		工单类型Id 1,投放工单 2,补货工单 3,维修工单 4,撤机工单
desc	string	必须		描述信息
details	object []	非必须		补货信息(补货工单才有)	item 类型: object
├─ channelCode	string	非必须		货道编号
├─ expectCapacity	number	非必须		补货数量
├─ skuId	number	非必须		商品Id
├─ skuName	string	非必须		商品名称
├─ skuImage	string	非必须		商品图片

返回数据

名称	类型	是否必须	默认值	备注	其他信息
msg	string	必须
code	number	必须

查看工单列表

基本信息

Path： /manage/task/list

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
pageNum	是
pageSize	是
taskCode	否		工单编号
taskStatus	否		工单状态
productTypeId	否		工单类型
params[isRepair]	是	true	true 运维工单 false运营工单

返回数据

名称	类型	是否必须	默认值	备注	其他信息
total	number	必须
rows	object []	必须			item 类型: object
├─ createTime	string	必须
├─ taskId	number	必须
├─ taskCode	string	必须
├─ taskStatus	number	必须
├─ createType	number	必须
├─ innerCode	string	必须
├─ userId	number	必须
├─ userName	string	必须
├─ regionId	number	必须
├─ desc	string	必须
├─ productTypeId	number	必须
├─ assignorId	number	必须
├─ addr	string	必须
├─ taskType	object	必须		工单类型
├─ typeId	number	必须
├─ typeName	string	必须
├─ type	number	必须
code	number	必须
msg	string	必须

查看工单补货详情

基本信息

Path： /manage/taskDetails/byTaskId/:taskId

Method： GET

接口描述：

请求参数

路径参数

参数名称	示例	备注
taskId		工单id

返回数据

名称	类型	是否必须	默认值	备注	其他信息
msg	string	必须
code	number	必须
data	object []	必须			item 类型: object
├─ createTime	null	必须
├─ updateTime	null	必须
├─ detailsId	number	必须
├─ taskId	number	必须
├─ channelCode	string	必须
├─ expectCapacity	number	必须
├─ skuId	null	必须
├─ skuName	string	必须
├─ skuImage	string	必须

根据售货机获取维修人员列表

基本信息

Path： /manage/emp/operationList/:innerCode

Method： GET

接口描述：

请求参数

路径参数

参数名称	示例	备注
innerCode		设备编号

返回数据

名称	类型	是否必须	默认值	备注	其他信息
msg	string	必须
code	number	必须
data	object []	必须			item 类型: object
├─ createBy	null	必须
├─ createTime	null	必须
├─ updateBy	null	必须
├─ updateTime	null	必须
├─ remark	null	必须
├─ id	number	必须
├─ userName	string	必须
├─ regionId	number	必须
├─ regionName	string	必须
├─ roleId	number	必须
├─ roleCode	string	必须
├─ roleName	string	必须
├─ mobile	string	必须
├─ image	string	必须
├─ status	number	必须

根据售货机获取运营人员列表

基本信息

Path： /manage/emp/businessList/:innerCode

Method： GET

接口描述：

请求参数

路径参数

参数名称	示例	备注
innerCode		设备编号

返回数据

名称	类型	是否必须	默认值	备注	其他信息
msg	string	必须
code	number	必须
data	object []	必须			item 类型: object
├─ createBy	null	必须
├─ createTime	null	必须
├─ updateBy	null	必须
├─ updateTime	null	必须
├─ remark	null	必须
├─ id	number	必须
├─ userName	string	必须
├─ regionId	number	必须
├─ regionName	string	必须
├─ roleId	number	必须
├─ roleCode	string	必须
├─ roleName	string	必须
├─ mobile	string	必须
├─ image	string	必须
├─ status	number	必须

商品管理

批量导入

基本信息

Path： /manage/sku/import

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	multipart/form-data	是
Authorization	Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6ImNlNGU5MWZhLTBhYTItNGZjMy05N2E3LThkNTc0ZjczMGNjNyJ9.m8Ez4tmOb-jxAD9lQYFXQdmXUT-beKbrnu7EdqfFF9CUawkAlQsE5wWCYhqVzIVQn0KqrQa2x2o6my94i5UaDA	是		身份令牌

Body

参数名称	参数类型	是否必须	示例	备注
file	file	是		excel上传文件

返回数据

名称	类型	是否必须	默认值	备注	其他信息
msg	string	必须		操作成功
code	number	必须		200

查询商品列表

基本信息

Path： /manage/sku/list

Method： GET

接口描述：

请求参数

Query

参数名称	是否必须	示例	备注
skuName	否		商品名称
pageIndex	是	1	当前页
pageSize	是	10	每页个数

返回数据

名称	类型	是否必须	默认值	备注	其他信息
total	number	非必须
rows	object []	非必须			item 类型: object
├─ skuId	number	非必须
├─ skuName	string	非必须
├─ skuImage	string	非必须
├─ brandName	string	非必须
├─ unit	string	非必须
├─ price	number	非必须
├─ classId	number	非必须
code	number	非必须
msg	string	非必须