API接口文档／2.4 商品服务／2.4.7 商品库存查询
在线测试
2.4.7 商品库存查询

根据商品编码与区域（省市区县）查询对应区域商品库存信息，根据区域估算出预计送达

请求方式/参数格式
POST/JSON
请求URL
https://域名/stocks
请求入参说明
参数名称 必填 类型 长度 示例值
token 是 String 100 授权接口获取的access token
skus 是 String 500 商品编号，支持批量查询，以英文逗号","分隔
area 是 String 100 格式：1_12_111，库存最多支持三级地址：省_市_区/县
返回结果
名称 类型 必填 备注
success boolean 是 true|false，根据该字段判断接口是否调用成功，若为false，则解析error_response字段查看具体失败原因
result Array 是 数组对象，数据节点
 â””sku String 是 商品编号
 â””area String 是 区域
 â””num int 是 数量
 â””send_day String 否 送达日
 â””desc String 否 描述
错误码
错误码 错误描述 解决方案
ERR-000011 Token 不存在
ERR-000013 Token 不能为空
ERR-000014 Token参数数据类型为字符串
ERR-000015 token_expired
请求示例
  • 1
  • 2
  • 3
  • 4
{
  "token": "3fd5f04b-9f4c-4be0-8ea2-31f912314181",
  "skus": "10301291,10300001",
  "area": "13_1042_1044"
}
返回示例
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
{
  "result": [
    {
      "area": "13_1042_1044",
      "num": "10000",
      "send_day": "预计7日送达",
      "sku": "10301291",
      "desc": "有货"
    },
    {
      "area": "13_1042_1044",
      "num": "10000",
      "send_day": "预计7日送达",
      "sku": "10300001",
      "desc": "有货"
    }
  ],
  "success": true
}