仓库列表信息接口

提供仓库列表信息的查询能力，支持根据国家二字码和发货模式筛选仓库信息。

适用场景

查询特定国家和发货模式下的仓库列表

接口类型

POST

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/depot/list
测试环境：https://testing.westmonth.com/openapi/depot/list

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
country_codes	array	否	-	-	国家二字码，数组
pattern_types	array	否	-	0：快递配送、1：第三方物流自提、2：个人自提	发货模式，数组

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功，1表示服务错误，2表示参数错误，3表示授权无效，4表示请求上限）
msg	string	错误描述
data	array	业务数据（仓库列表信息）

data数组字段

字段	类型	说明
id	integer	仓库id
name	string	仓库代号
depost_name	string	仓库名称
delivery_region_id	integer	发货区域ID
delivery_region_name	string	发货区域名称
wms_co_id	integer	WMS公司ID
wms_server_id	integer	WMS服务器ID
sort	integer	权重
pattern_type	array	发货模式（0：快递配送，1：第三方物流自提，2：个人自提）
warehouse_code	string	仓库编码
warehouses	array	仓库地址列表

warehouses数组字段

字段	类型	说明
address	string	仓库地址
contact_name	string	仓库负责人
postcode	string	仓库邮政编码
contact_phone	string	仓库负责人联系电话

调用示例

URL请求

请求示例

{
    "country_codes": [
        "US"
    ],
    "pattern_types": []
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "id": 3,
            "name": "美国1仓",
            "depost_name": "美国万邑通仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 13625047,
            "wms_server_id": 1,
            "sort": 1,
            "pattern_type": [
                "0",
                "1",
                "2"
            ],
            "warehouses": [
                {
                    "depot_id": 3,
                    "address": "2125 Gateway Blvd, Hebron, KY 41048（周一~周五, 法定假日除外）, 12:00-17:00",
                    "contact_name": "wangweixuan",
                    "contact_phone": "8594850550",
                    "postcode": "41048"
                }
            ]
        },
        {
            "id": 11,
            "name": "美国2仓",
            "depost_name": "美国万邑通美西仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 14194305,
            "wms_server_id": 1,
            "sort": 2,
            "pattern_type": [
                "0",
                "1",
                "2"
            ],
            "warehouses": [
                {
                    "depot_id": 11,
                    "address": "381 S Brea Canyon Road ，Walnut CA 91789（周一~周五, 法定假日除外）：12:00-17:00",
                    "contact_name": "Willie Lam",
                    "contact_phone": "6266060308",
                    "postcode": "91789"
                }
            ]
        },
        {
            "id": 7,
            "name": "美国4仓",
            "depost_name": "美国新势力仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 13839184,
            "wms_server_id": 5,
            "sort": 4,
            "pattern_type": [
                "0",
                "1"
            ],
            "warehouses": [
                {
                    "depot_id": 7,
                    "address": "2225 Grant Ave, San Lorenzo, CA 94580",
                    "contact_name": "MSS/XSL-EASON",
                    "contact_phone": "415-937-2077",
                    "postcode": "94580"
                }
            ]
        },
        {
            "id": 17,
            "name": "美国12仓",
            "depost_name": "美国-京东仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 14198179,
            "wms_server_id": 9,
            "sort": 6,
            "pattern_type": [
                "0",
                "1"
            ],
            "warehouses": [
                {
                    "depot_id": 17,
                    "address": "1570 S. Washington Avenue, Piscataway, Middlesex County, New Jersey",
                    "contact_name": "shlyaaa",
                    "contact_phone": "2135515825",
                    "postcode": "08854"
                }
            ]
        },
        {
            "id": 34,
            "name": "美国15仓",
            "depost_name": "美国-洛杉矶仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 14653464,
            "wms_server_id": 2,
            "sort": 10,
            "pattern_type": [
                "0",
                "1"
            ],
            "warehouses": [
                {
                    "depot_id": 34,
                    "address": "11600 Los Nietos Road, Santa Fe Springs, CA",
                    "contact_name": "RAY ZHAO",
                    "contact_phone": "626-264-7515",
                    "postcode": "90670"
                }
            ]
        },
        {
            "id": 27,
            "name": "美国8仓",
            "depost_name": "美国休斯顿自建仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 14251327,
            "wms_server_id": 10,
            "sort": 11,
            "pattern_type": [
                "0",
                "1"
            ],
            "warehouses": [
                {
                    "depot_id": 27,
                    "address": "750 Almeda Genoa Rd Suite B, Houston, TX",
                    "contact_name": "Anna Gao/Qin Gao",
                    "contact_phone": "(US+1)2674143213",
                    "postcode": "77047"
                }
            ]
        },
        {
            "id": 36,
            "name": "美国16仓",
            "depost_name": "马帮休斯顿仓-香港志南资讯有限公司",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 14251327,
            "wms_server_id": 10,
            "sort": 20,
            "pattern_type": [],
            "warehouses": [
                {
                    "depot_id": 36,
                    "address": "750 Almeda Genoa Rd Suite B, Houston, TX",
                    "contact_name": "Anna Gao/Qin Gao",
                    "contact_phone": "(US+1)2674143213",
                    "postcode": "77047"
                }
            ]
        }
    ]
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

常见问题

Q1：如何获取有效的国家二字码？

A：国家二字码遵循国际标准ISO 3166-1 alpha-2，可通过相关国际标准文档或权威网站查询。

版本历史

版本	日期	修改说明
v1.0	2025-01-01	初始版本

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "id": 3,
            "name": "美国1仓",
            "depost_name": "美国万邑通仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 13625047,
            "wms_server_id": 1,
            "sort": 0,
            "pattern_type": [
                "0",
                "1",
                "2"
            ],
            "warehouses": [
                {
                    "depot_id": 3,
                    "address": "2125 Gateway Blvd, Hebron, KY 41048（周一~周五, 法定假日除外）, 12:00-17:00",
                    "contact_name": "wangweixuan",
                    "contact_phone": "8592799537",
                    "postcode": "41048"
                }
            ]
        },
        {
            "id": 11,
            "name": "美国2仓",
            "depost_name": "美国万邑通美西仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 14194305,
            "wms_server_id": 1,
            "sort": 1,
            "pattern_type": [
                "0",
                "1",
                "2"
            ],
            "warehouses": [
                {
                    "depot_id": 11,
                    "address": "381 S Brea Canyon Road ，Walnut CA 91789（周一~周五, 法定假日除外）：12:00-17:00",
                    "contact_name": "Willie Lam",
                    "contact_phone": "6266060308-5705",
                    "postcode": "91789"
                }
            ]
        },
        {
            "id": 13,
            "name": "美国3仓",
            "depost_name": "美国直新",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 13799844,
            "wms_server_id": 8,
            "sort": 2,
            "pattern_type": [
                "0",
                "1"
            ],
            "warehouses": [
                {
                    "depot_id": 13,
                    "address": "1724 5th Ave, Bay Shore, NY 11706",
                    "contact_name": "Cindy+CFNS",
                    "contact_phone": "+1(917)770-1819",
                    "postcode": "11706"
                }
            ]
        },
        {
            "id": 27,
            "name": "美国8仓",
            "depost_name": "美国休斯顿自建仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 14251327,
            "wms_server_id": 10,
            "sort": 5,
            "pattern_type": [],
            "warehouses": [
                {
                    "depot_id": 27,
                    "address": "750 Almeda Genoa Rd Suite B, Houston, TX",
                    "contact_name": "Anna Gao/Qin Gao",
                    "contact_phone": "(US+1)2674143213",
                    "postcode": "77047"
                }
            ]
        },
        {
            "id": 20,
            "name": "美国14仓",
            "depost_name": "美国-易达云8仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 14382105,
            "wms_server_id": 11,
            "sort": 7,
            "pattern_type": [
                "0",
                "1"
            ],
            "warehouses": [
                {
                    "depot_id": 20,
                    "address": "Deliver Address: 951 Coopertown Rd, Delanco, NJ",
                    "contact_name": "M5664/doudou",
                    "contact_phone": "732-515-9018",
                    "postcode": "08075"
                }
            ]
        },
        {
            "id": 24,
            "name": "美国6仓",
            "depost_name": "美国-阔仓美西仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 14236683,
            "wms_server_id": 8,
            "sort": 8,
            "pattern_type": [],
            "warehouses": [
                {
                    "depot_id": 24,
                    "address": "6015 Randolph St, unit B Commerce, CA",
                    "contact_name": "Feng Mai",
                    "contact_phone": "6264296687",
                    "postcode": "90040"
                }
            ]
        },
        {
            "id": 31,
            "name": "美国13仓",
            "depost_name": "美国-易达云7仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 14197035,
            "wms_server_id": 0,
            "sort": 10,
            "pattern_type": [],
            "warehouses": []
        },
        {
            "id": 17,
            "name": "美国12仓",
            "depost_name": "美国-京东仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 14198179,
            "wms_server_id": 9,
            "sort": 66,
            "pattern_type": [
                "0",
                "1"
            ],
            "warehouses": [
                {
                    "depot_id": 17,
                    "address": "1570 S. Washington Avenue, Piscataway, Middlesex County, New Jersey",
                    "contact_name": "shlyaaa",
                    "contact_phone": "2135515825",
                    "postcode": "08854"
                }
            ]
        },
        {
            "id": 7,
            "name": "美国4仓",
            "depost_name": "美国新势力仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 13839184,
            "wms_server_id": 5,
            "sort": 100,
            "pattern_type": [
                "0",
                "1"
            ],
            "warehouses": [
                {
                    "depot_id": 7,
                    "address": "2225 Grant Ave, San Lorenzo, CA 94580",
                    "contact_name": "MSS/XSL-EASON",
                    "contact_phone": "415-937-2077",
                    "postcode": "94580"
                }
            ]
        },
        {
            "id": 8,
            "name": "美国出口易直新仓",
            "depost_name": "美国直新仓",
            "delivery_region_id": 3,
            "delivery_region_name": "美国",
            "wms_co_id": 0,
            "wms_server_id": 1,
            "sort": 991,
            "pattern_type": [],
            "warehouses": []
        }
    ]
}

仓库列表信息

仓库列表信息接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

Q1：如何获取有效的国家二字码？#

版本历史#

请求参数

请求示例代码

返回响应

仓库列表信息接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：如何获取有效的国家二字码？

版本历史