Qeasy Cloud
Get Started

领星ERP 查询物流 - 头程物流商 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
物流 · POST · 请求参数 8 个(必填 0) · 响应参数 25 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询物流 - 头程物流商

POST/basicOpen/logistics/headLogisticsProvider/query/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/logistics/headLogisticsProvider/query/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/logistics/headLogisticsProvider/query/list?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"search\": {\n        \"page\": 1,\n        \"length\": 20\n    }\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583.178.17255922733991817",
    "response_time": "2024-11-12 16:00:00",
    "data": {
      "total": 3,
      "providers": [
        {
          "providerId": "PROV001",
          "name": "顺丰速运",
          "code": "SFEXPRESS",
          "enabled": 1,
          "logisticsType": 1,
          "isAuth": 1,
          "supplierCode": 1001,
          "supplierName": "顺丰集团",
          "status": 1,
          "remark": "国内主要快递服务商",
          "payMethod": 1,
          "contactName": "王经理",
          "contactPhone": "13812345678",
          "creatorId": 10001,
          "creatorName": "管理员A",
          "createdAt": 1704067200
        },
        {
          "providerId": "PROV002",
          "name": "DHL国际快递",
          "code": "DHLINTL",
          "enabled": 1,
          "logisticsType": 3,
          "isAuth": 1,
          "supplierCode": 2001,
          "supplierName": "DHL集团",
          "status": 1,
          "remark": "全球领先的国际快递服务商",
          "payMethod": 2,
          "contactName": "李女士",
          "contactPhone": "13987654321",
          "creatorId": 10002,
          "creatorName": "管理员B",
          "createdAt": 1704067300
        },
        {
          "providerId": "PROV003",
          "name": "菜鸟裹裹",
          "code": "CAINIAO",
          "enabled": 1,
          "logisticsType": 4,
          "isAuth": 1,
          "supplierCode": 3001,
          "supplierName": "阿里巴巴",
          "status": 1,
          "remark": "平台聚合物流服务",
          "payMethod": 1,
          "contactName": "赵先生",
          "contactPhone": "13700112233",
          "creatorId": 10001,
          "creatorName": "管理员A",
          "createdAt": 1704067400
        }
      ]
    },
    "total": 3
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1search搜索参数对象object—Optional搜索参数对象
1.1length分页长度integer—Optional分页长度,每页显示的记录数
1.2page页码integer—Optional页码,从1开始
1.3enabled启用状态integer—Optional启用状态,枚举值:0-禁用, 1-启用,默认启用
1.4isAuth是否api对接integer—Optional是否api对接,枚举值:0-否, 1-是,默认是
1.5payMethod结算方式integer—Optional结算方式,枚举值:1-现结, 2-月结,默认现结
1.6searchField搜索字段string—Optional搜索字段,指定搜索的目标字段名称,code 代码 ,name 物流商,默认物流商
1.7searchValue搜索值string—Optional搜索值,用于模糊搜索物流商名称、编码等

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code响应码integer—Required响应码
2data返回数据object—Required返回数据
2.1total总记录数integer100Required总记录数
2.2providers物流商列表array<object>—Required物流商列表
2.2.1providerId物流商idstring—Optional物流商id
2.2.2name物流商名string—Optional物流商名
2.2.3code物流商代码string—Optional物流商代码
2.2.4enabled是否启用 0禁用 1 启用integer—Optional是否启用 0禁用 1 启用
2.2.5logisticsType类型integer—Optional类型 0 API物流 1 自定义物流 2 第三方仓物流 3 头程物流 4 平台物流
2.2.6isAuth是否api对接integer—Optional是否api对接 0 否 1 是
2.2.7supplierCode授权方codeinteger—Optional授权方code
2.2.8supplierName授权方string—Optional授权方
2.2.9status授权状态integer—Optional授权状态 0 未授权 1 已授权
2.2.10remark备注string—Optional备注
2.2.11payMethod结算方式integer—Optional结算方式
2.2.12contactName联系人string—Optional联系人
2.2.13contactPhone联系电话string—Optional联系电话
2.2.14creatorId创建人idinteger—Optional创建人id
2.2.15creatorName创建人名string—Optional创建人名
2.2.16createdAt创建时间integer—Optional创建时间,Unix时间戳(秒)
3error_details错误详情array<any>—Required错误详情
4message提示信息string—Required提示信息
5request_id请求idstring—Required请求id
6response_time响应时间string—Required响应时间
7total总记录数integer—Required总记录数

The 查询物流 - 头程物流商 API (/basicOpen/logistics/headLogisticsProvider/query/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.