列出库位

GET

/api/v1/locations

Locations

检索库位的分页列表，允许过滤和排序。

所需权限： warehouse:read

使用场景：

查询可用库位进行库存分配

获取库位列表用于拣货路径规划

系统集成时同步库位信息

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://gwms.jmalltech.com/api-gateway/api/v1/locations?pageNumber&pageSize&sort&isAsc&warehouseId&zoneId&code&status' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200成功

application/json

库位的分页列表。

Body

示例

{
    "success": true,
    "message": "Success",
    "code": "200",
    "timestamp": "2024-01-01T00:00:00Z",
    "data": [
        {
            "createBy": 1,
            "createTime": "2024-01-01T10:00:00Z",
            "updateBy": 1,
            "updateTime": "2024-01-01T10:30:00Z",
            "params": {
                "key1": "value1",
                "key2": "value2"
            },
            "locationId": 3001,
            "warehouseId": 1001,
            "zoneId": 2001,
            "warehouseName": "苏州主仓",
            "zoneName": "A区",
            "code": "A01-01-01",
            "sort": 1,
            "remark": "靠近出入口的库位",
            "status": "ENABLED"
        }
    ],
    "pagination": {
        "total": 100,
        "pageNumber": 1,
        "size": 20
    }
}

🟠400请求有误

🟠401未认证

🔴500服务器内部错误

修改于 2025-09-10 07:08:13

获取库区详情

获取库位详情