查询虚拟仓
请求地址
环境 | 服务地址(HTTP/HTTPS) |
---|---|
V2正式环境(推荐) | https://gw.superboss.cc/router |
2022年4月1日以后申请的APP Key,统一使用V2正式环境的请求地址:https://gw.superboss.cc/router
公共参数
调用任何一个API都必须传入的参数,目前支持的公共参数有:
参数名称 | 参数类型 | 是否必须 | 参数描述 |
---|---|---|---|
method | string | 是 | API接口名称 |
appKey | string | 是 | 分配给应用的AppKey |
timestamp | string | 是 | 时间戳,时区为GMT+8,例如:2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟 |
format | string | 否 | 响应格式。默认为json格式,可选值:json |
version | string | 是 | API协议版本 可选值:1.0 |
sign_method | string | 否 | 签名的摘要算法(默认 hmac),可选值为:hmac,md5,hmac-sha256。 |
sign | string | 是 | 签 名 |
session | string | 是 | 授权会话信息 (即access_token,由系统分配) |
请求头
参数名
类型
描述
必填
Content-Type
string
multipart/form-data
必填
API接口地址
参数名
类型
描述
必填
method
string
erp.virtual.warehouse.query
必填
请求参数
参数名
类型
描述
必填
name
string
虚拟仓名称
pageNo
int
页码(从1开始)
pageSize
int
分页大小(最大500)
必填
请求示例
示例一:
{
"name":"string",
"pageNo":1,
"pageSize":50
}
响应参数
参数名
类型
描述
必填
list
object
虚拟仓列表
必填
id
long
虚拟仓ID
必填
name
string
虚拟仓名称
必填
warehouseId
long
归属仓库ID
必填
warehouseName
string
归属仓库名称
必填
status
string
状态 , 正常/未知
必填
created
string
创建时间
必填
modified
string
修改时间
必填
memberList
array
成员
必填
name
string
成员名称
必填
type
int
类型
必填
memberId
long
成员ID
必填
success
boolean
示例:true
必填
trace_id
string
示例:3553483395407017
必填
total
long
总数
必填
响应示例
{
"traceId": "2631454043714238433",
"list":
[
{
"created": "2021-04-16 11:27:13",
"creatorName": "超级管理员",
"warehouseName": "正木仓库",
"memberList":
[
{
"name": "木子小店",
"type": 1,
"memberId": 75729
},
{
"name": "秋妈Rachel 优选童品",
"type": 1,
"memberId": 54415
}
],
"lockStatus": 1,
"itemStock": 4,
"warehouseId": 31358,
"name": "第一个仓库1",
"modified": "2022-09-05 10:30:45",
"modifierName": "超级管理员",
"id": 2,
"ratio": 0,
"status": "正常"
},
{
"created": "2021-04-02 15:35:11",
"creatorName": "超级管理员",
"warehouseName": "默认仓库",
"itemStock": 20,
"warehouseId": 1871,
"name": "cc",
"modified": "2022-08-25 11:15:06",
"modifierName": "超级管理员",
"id": 3,
"ratio": 0,
"status": "正常"
}
],
"total": 23,
"success": true
}
异常示例
{
"code": "25",
"msg": "服务方法(item.single.get:1.0)的签名无效",
"success": false,
"trace_id": "3553483395423660"
}
错误码解释
错误码 | 错误信息 | 解决方案 |
---|---|---|
content1 | content2 | content3 |