接口文档

1、获取设备信息

GET http://localhost:58080/admin-api/system/smart-device/android/getInfoByCode?deviceCode=WLKF001
Accept: /

接口1返回内容：
{
"code": 0,
"msg": "",
"data": {
"id": 1,
"deviceCode": "WLKF001",
"deviceName": "物料库房",
"responsiblePerson": "az",
"contactInfo": "18888888888",
"deviceLocation": "库房",
"supervisor": "河南鲸芯",
"ip": null,
"mac": null,
"factoryId": 2,
"factoryName": "A厂区",
"areaId": 1,
"areaName": "车间1",
"logoId": 1,
"logoName": "默认logo",
"logoUrl": "http://203.56.161.201:9000/yudao/20260811/1.jpg",
"carouselId": 1,
"carouselName": "默认轮播图",
"carouselImageUrls": [
"http://203.56.161.201:9000/yudao/20260811/a.png",
"http://203.56.161.201:9000/yudao/20260811/%E9%95%BF%E5%AE%89%E6%B1%87%E9%80%9A.png"
],
"createTime": 1786437952168,
"tenantId": 1
}
}

2、设备上传IP和MAC地址

POST http://localhost:58080/admin-api/system/smart-device/android/updateIpAndMac
Accept: /
Content-Type: application/json

{
"id": 1,//接口1返回的id
"ip":"192.168.2.112",
"mac":"XX:XX"
}

成功返回 ：
{
"code": 0,
"msg": "",
"data": true
}

3、获取最新版本apk

GET http://localhost:58080/admin-api/system/smart-app/getLatestApk
Accept: /
Content-Type: application/json
Tenant-Id: 1

登录 - 账号密码

POST http://localhost:58080/admin-api/system/auth/login
Accept: /
Content-Type: application/json
Tenant-id: 1

{
"username": "lihao",
"password": "123456"
}

<> 2026-08-19T154554.200.json
<> 2026-08-19T145224.200.json

卡号登录

POST http://localhost:58080/admin-api/system/auth/loginByCard
Accept: /
Content-Type: application/json
Tenant-id: 1

{
"userCard": "12122"
}

<> 2026-08-19T135432.200.json
<> 2026-08-19T112257.200.json

人脸登录

POST http://localhost:58080/admin-api/system/auth/loginByFace
Accept: /
Content-Type: application/json
Tenant-id: 1

{
"userId": 145
}

成功返回：
{
"code": 0,
"msg": "",
"data": {
"userId": 145,
"accessToken": "db788f00b52647058c00015404108cf1",
"refreshToken": "fad9d5e15de34d04a656ddc45cfd8003",
"expiresTime": 1786691875333
}
}

app获取个人信息

GET http://localhost:58080/admin-api/system/user/profile/get
Accept: /
Content-Type: application/json
Authorization: Bearer 468d8acd1a3341a8a35081788df2a7af

<> 2026-08-19T110726.200.json

app修改个人信息

PUT http://localhost:58080/admin-api/system/user/profile/update
Accept: /
Content-Type: application/json
Authorization: Bearer 468d8acd1a3341a8a35081788df2a7af

{
"password": "123456",
"userCard": "12122",
"userPhoto": ""
}

上传图片

POST http://localhost:58080/admin-api/infra/file/upload
Accept: /
Content-Type: application/json
Authorization: Bearer 468d8acd1a3341a8a35081788df2a7af

<> 2026-08-19T111522.500.json

app端获取已绑定物料箱门信息分页

GET http://localhost:58080/admin-api/system/smart-door/appDoorPage?pageNo=1&pageSize=20&deviceId=1
Accept: /
Content-Type: application/json
Authorization: Bearer 802554ca28fc4b31bc25a1e1d2458820
Tenant-id: 1

<> 2026-08-19T145502.200.json
<> 2026-08-19T145456.200.json

app端获取柜体列表

GET http://localhost:58080/admin-api/system/smart-cabinet/simple-list?deviceId=1
Accept: /
Content-Type: application/json
Authorization: Bearer 560da2dbfc2547b783f4bb005441146b
Tenant-id: 1

<> 2026-08-19T154627.200.json
<> 2026-08-19T154545.200.json

app端获取所有箱门信息分页

GET http://localhost:58080/admin-api/system/smart-door/appAllDoorPage?pageNo=1&pageSize=20&deviceId=1&cabinetId=2087119498871021570&doorNo=19
Accept: /
Content-Type: application/json
Authorization: Bearer 560da2dbfc2547b783f4bb005441146b

<> 2026-08-19T154840.200.json

开箱

GET http://localhost:58080/admin-api/system/smart-door/openDoor?id=3
Accept: /
Content-Type: application/json
Authorization: Bearer 1e057335f47546fb8da2dd50e45e5b2e

清箱

POST http://localhost:58080/admin-api/system/smart-door/appClearDoor?id=41
Accept: /
Content-Type: application/json
Authorization: Bearer 1e057335f47546fb8da2dd50e45e5b2e

锁定箱门

POST http://localhost:58080/admin-api/system/smart-door/appLockDoor?id=4
Accept: /
Content-Type: application/json
Authorization: Bearer 802554ca28fc4b31bc25a1e1d2458820

解锁箱门

POST http://localhost:58080/admin-api/system/smart-door/appUnlockDoor?id=4
Accept: /
Content-Type: application/json
Authorization: Bearer 802554ca28fc4b31bc25a1e1d2458820

<> 2026-08-19T145257.200.json

APP 获取物料类型列表

GET http://localhost:58080/admin-api/system/smart-consumable-type/simple-list
Accept: /
Content-Type: application/json
Authorization: Bearer 560da2dbfc2547b783f4bb005441146b
Tenant-id: 1

APP 获取部门列表

GET http://localhost:58080/admin-api/system/dept/simple-list
Accept: /
Content-Type: application/json
Authorization: Bearer e96fe74fe95e41b48ac5099771d47f62

Tenant-id: 1

领用、补货、退料

POST http://localhost:58080/admin-api/system/smart-consumable-order/handle
Accept: /
Content-Type: application/json
Authorization: Bearer e96fe74fe95e41b48ac5099771d47f62
Tenant-id: 1

{
"deviceId":1,
"deptId": 118,
"handleType":1,
"doorList":[
{"id":3,"count":1},
{"id":4,"count":1}
]
}