物流公司列表接口

提供物流公司列表的查询能力，支持分页查询特定国家的物流公司信息。

适用场景

分页查询特定国家的物流公司列表

获取物流公司的中文名称、英文名称、编码等信息

接口类型

POST

请求频率限制

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

请求说明

请求URL

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

请求参数

Header参数

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

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
page	integer	否	1	-	页码
size	integer	否	20	-	每页条数
country_codes	array	否	-	-	国家二字码，数组

响应字段说明

成功响应（HTTP 200）

根字段

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

data对象字段

字段	类型	说明
list	array	物流公司列表
total	integer	总条数
page	integer	当前页码
size	integer	每页条数
numPage	integer	最后一页页码

list数组字段

字段	类型	说明
name	string	物流公司中文名称
name_en	string	物流公司英文名称
code	string	物流公司编码
country_code	string	国家二字码

调用示例

URL请求

请求示例

{
    "page": 1,
    "size": 10,
    "country_codes": [
        "CN"
    ]
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": {
        "list": [
            {
                "name": " JX2U",
                "name_en": " JX2U",
                "code": "JX006",
                "country_code": "CN"
            },
            {
                "name": "物邮供应链",
                "name_en": "WUYOU",
                "code": "QI002",
                "country_code": "CN"
            },
            {
                "name": "139Express",
                "name_en": "139Express",
                "code": "EX011",
                "country_code": "CN"
            },
            {
                "name": "17EXP",
                "name_en": "17EXP",
                "code": "EX006",
                "country_code": "CN"
            },
            {
                "name": "17FEIA",
                "name_en": "17FEIA",
                "code": "FE011",
                "country_code": "CN"
            },
            {
                "name": "一代集团",
                "name_en": "1ST",
                "code": "ST001",
                "country_code": "CN"
            },
            {
                "name": "一站到岸",
                "name_en": "1STOP",
                "code": "ST027",
                "country_code": "CN"
            },
            {
                "name": "1TONG",
                "name_en": "1TONG",
                "code": "TO009",
                "country_code": "CN"
            },
            {
                "name": "二一八国际物流",
                "name_en": "218 Logistics",
                "code": "LO004",
                "country_code": "CN"
            },
            {
                "name": "2GO",
                "name_en": "2GO",
                "code": "GO001",
                "country_code": "PH"
            },
            {
                "name": "3CLIQUES",
                "name_en": "3CLIQUES",
                "code": "CL002",
                "country_code": "CN"
            },
            {
                "name": "圣大",
                "name_en": "3DADA",
                "code": "DA003",
                "country_code": "CN"
            },
            {
                "name": "3JMS Logistics",
                "name_en": "3JMS Logistics",
                "code": "JM002",
                "country_code": "US"
            },
            {
                "name": "4CUS",
                "name_en": "4CUS",
                "code": "CU002",
                "country_code": "US"
            },
            {
                "name": "4PL实验室",
                "name_en": "4PLLAB",
                "code": "PL002",
                "country_code": "CN"
            },
            {
                "name": "递四方",
                "name_en": "4PX",
                "code": "PX001",
                "country_code": "CN"
            },
            {
                "name": "5UL",
                "name_en": "5UL",
                "code": "UL001",
                "country_code": "CN"
            },
            {
                "name": "六洲速通",
                "name_en": "6ZEX",
                "code": "ZE003",
                "country_code": "CN"
            },
            {
                "name": "7TM",
                "name_en": "7TM",
                "code": "TM001",
                "country_code": "CN"
            },
            {
                "name": "A Tiempo Cargo ",
                "name_en": "A Tiempo Cargo ",
                "code": "AT005",
                "country_code": "US"
            }
        ],
        "total": 4165,
        "page": 1,
        "size": 20,
        "numPage": 209
    }
}

失败返回示例

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

错误处理

公共错误码

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

常见问题

Q1：如何获取不同国家的物流公司列表？

A：在请求参数的country_codes数组中传入对应的国家二字码即可，例如传入["US"]可获取美国的物流公司列表。

Q2：如果需要获取更多页的物流公司信息，该如何操作？

A：通过修改page参数的值来获取不同页的信息，例如page=2表示获取第2页的物流公司列表，同时可根据numPage字段确定总页数。

版本历史

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

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": {
        "list": [
            {
                "name": " JX2U",
                "name_en": " JX2U",
                "code": "JX006",
                "country_code": "CN"
            },
            {
                "name": "物邮供应链",
                "name_en": " QIANYU",
                "code": "QI002",
                "country_code": "CN"
            },
            {
                "name": "139Express",
                "name_en": "139Express",
                "code": "EX011",
                "country_code": "CN"
            },
            {
                "name": "17EXP",
                "name_en": "17EXP",
                "code": "EX006",
                "country_code": "CN"
            },
            {
                "name": "17FEIA",
                "name_en": "17FEIA",
                "code": "FE011",
                "country_code": "CN"
            },
            {
                "name": "一代集团",
                "name_en": "1ST",
                "code": "ST001",
                "country_code": "CN"
            },
            {
                "name": "一站到岸",
                "name_en": "1STOP",
                "code": "ST027",
                "country_code": "CN"
            },
            {
                "name": "1TONG",
                "name_en": "1TONG",
                "code": "TO009",
                "country_code": "CN"
            },
            {
                "name": "二一八国际物流",
                "name_en": "218 Logistics",
                "code": "LO004",
                "country_code": "CN"
            },
            {
                "name": "3CLIQUES",
                "name_en": "3CLIQUES",
                "code": "CL002",
                "country_code": "CN"
            }
        ],
        "total": 2725,
        "page": 1,
        "size": 10,
        "numPage": 273
    }
}

物流公司列表

物流公司列表接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：如何获取不同国家的物流公司列表？

Q2：如果需要获取更多页的物流公司信息，该如何操作？

版本历史

请求参数

请求示例代码

返回响应

物流公司列表

物流公司列表接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

Q1：如何获取不同国家的物流公司列表？#

Q2：如果需要获取更多页的物流公司信息，该如何操作？#

版本历史#

请求参数

请求示例代码

返回响应

物流公司列表接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：如何获取不同国家的物流公司列表？

Q2：如果需要获取更多页的物流公司信息，该如何操作？

版本历史