eTowerOne Developers
页面树结构
转至元数据结尾
转至元数据起始

接口名称

获取上传服务列表 (Get Upload Service By Shipper)

接口地址

/api/shipper/v1/channel/getUploadServiceByShipperSelect

请求方式

POST

接口描述

该接口用于根据发件网点和目的国家获取可用的上传服务渠道列表。用户在"上传订单"页面选择网点或国家后，会自动调用此接口刷新服务选项。

请求头

参数

类型

必填

说明

sessionId

String

是

登录会话ID

language

String

是

语言

Content-Type

String

是

application/json;charset=UTF-8

语言取值：

值

说明

zh_CN

中文

en_US

英文

请求参数

参数

类型

必填

说明

facility

String

是

发件网点代码，"*"表示所有网点

country

String

是

目的国家代码，如"US"、"CN"等

参数说明

*facility - 发件网点代码*

  • 默认值："*"（所有网点）
  • 具体值：从"发件网点列表"接口获取
  • 影响返回的服务列表

*country - 目的国家代码*

  • 格式：ISO国家代码，如 "US"、"CN"、"AU" 等
  • 为空字符串：返回所有国家的服务
  • 必填：需要指定具体国家

请求示例

curl 'https://tracking-qa.etowertech.com/api/shipper/v1/channel/getUploadServiceByShipperSelect' \
  -H 'Accept: application/json, text/plain, */*' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'language: zh_CN' \
  -H 'sessionId: vP1l43F_OqvoTUWBcaAtyg' \
  --data-raw '{
    "facility": "*",
    "country": "US"
  }'

返回示例

{
  "success": true,
  "code": "0",
  "data": [
    {
      "id": 456,
      "name": "Australia Post Standard",
      "code": "AUS_POST_STD"
    },
    {
      "id": 789,
      "name": "DHL Express",
      "code": "DHL_EXPRESS"
    },
    {
      "id": 929,
      "name": "FedEx International",
      "code": "FEDEX_INTL"
    }
  ],
  "errors": []
}

返回字段说明

*响应顶层字段：*

字段

类型

说明

success

Boolean

请求是否成功

code

String

响应状态码，"0"表示成功

data

Array[Object]

服务渠道列表数据

errors

Array

错误信息列表

*data 服务字段说明：*

字段

类型

说明

id

Number

服务渠道ID（用于上传时指定）

name

String

服务渠道名称

code

String

服务渠道代码

  • 无标签