1. 接口
Help for ShipSage
  • 中文版 V2.0
    • 接口集成
      • OMS API
        • 入门指南
        • 接口
          • 店铺
          • 仓库
          • 产品
          • 库存
          • 订单
          • 包裹
          • 物流跟踪
          • 发货计划
          • 转运
          • 增值服务
          • 退货
          • 文件上传
  • English V2.0
    • API Integration
      • OMS API
        • Getting Started
        • APIs
          • Account
          • Warehouse
          • Product
          • Inventory
          • Order
          • Shipping
          • Tracking
          • ASN
          • Transfer
          • VAS
          • Return
          • File Upload
  1. 接口

仓库

端点#

方法端点描述
GET/api/v202206/warehouses获取仓库列表
[新增] v202608 补丁(2026-09 新增):
现有 GET /api/v202206/warehouses 响应新增 shipping_services 字段(仓库启用的物流渠道清单)
以下为本次新增内容与说明。

头部#

键值
AuthorizationBearer eyJ0eXAiOiJKV1QiLCJhbGciOi ...

GET /api/v202206/warehouses (获取仓库列表)#

请求#

参数#
类型名称描述必填/选填数据结构
queryapiAPI 类型

可用值:
index.by-default
必填enum
请求示例#
GET /api/v202206/warehouses?api=index.by-default

返回#

键值
errcode0/4000
errmsgok/Error Info
dataData Properties
Data properties#
名称描述数据结构
warehouse_id仓库 idinteger
warehouse_name仓库名称string
address1街道地址1string
address2街道地址2string
country国家string
state州/省string
zip邮编string
city城市string
phone电话string
fax传真string
shipping_services当前可用的物流渠道数组(无启用则为空数组)array
shipping_services 子结构#
名称描述数据结构
carrier承运商
示例:FedEx / UPS / USPS / DHL
string
carrier_service承运商服务名
示例:FedEx Ground / FedEx Ground Home Delivery / UPS Next Day Air
string
返回示例#
{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "items": [
            {
                "warehouse_id": 100,
                "warehouse_name": "SG-MDW1",
                "address1": "460 Gibraltar Drive",
                "address2": null,
                "state": "IL",
                "zip": "60440",
                "city": "Bolingbrook",
                "phone": "888-566-8826",
                "fax": "8885081917",
                "country": "US",
                "shipping_services": [
                    { "carrier": "FedEx", "carrier_service": "FedEx Ground" },
                    { "carrier": "FedEx", "carrier_service": "FedEx Ground Home Delivery" },
                    { "carrier": "UPS",   "carrier_service": "UPS Next Day Air" }
                ]
            },
            {
                "warehouse_id": 101,
                "warehouse_name": "SG-SMF1",
                "address1": "2900 N MacArthur Dr Suite 150",
                "address2": null,
                "state": "CA",
                "zip": "95376",
                "city": "Tracy",
                "phone": "888-566-8826",
                "fax": "8885081917",
                "country": "US",
                "shipping_services": [
                    { "carrier": "FedEx", "carrier_service": "FedEx Ground" }
                ]
            }
        ]
    }
}
Modified at 2026-09-23 06:52:31
Previous
店铺
Next
产品
Built with