h2. 接口名称
获取上传服务列表 (Get Upload Service By Shipper)
h2. 接口地址
{code}
/api/shipper/v1/channel/getUploadServiceByShipperSelect
{code}
h2. 请求方式
{code}
POST
{code}
h2. 接口描述
该接口用于根据发件网点和目的国家获取可用的上传服务渠道列表。用户在"上传订单"页面选择网点或国家后,会自动调用此接口刷新服务选项。
h2. 请求头
|| 参数 || 类型 || 必填 || 说明 ||
| sessionId | String | 是 | 登录会话ID |
| language | String | 是 | 语言 |
| Content-Type | String | 是 | application/json;charset=UTF-8 |
*语言取值:*
|| 值 || 说明 ||
| zh_CN | 中文 |
| en_US | 英文 |
h2. 请求参数
|| 参数 || 类型 || 必填 || 说明 ||
| facility | String | 是 | 发件网点代码,"*"表示所有网点 |
| country | String | 是 | 目的国家代码,如"US"、"CN"等 |
h2. 参数说明
**facility - 发件网点代码**
- 默认值:"*"(所有网点)
- 具体值:从"发件网点列表"接口获取
- 影响返回的服务列表
**country - 目的国家代码**
- 格式:ISO国家代码,如 "US"、"CN"、"AU" 等
- 为空字符串:返回所有国家的服务
- 必填:需要指定具体国家
h2. 请求示例
{code}
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"
}'
{code}
h2. 返回示例
{code}
{
"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": []
}
{code}
h2. 返回字段说明
**响应顶层字段:**
|| 字段 || 类型 || 说明 ||
| success | Boolean | 请求是否成功 |
| code | String | 响应状态码,"0"表示成功 |
| data | Array[Object] | 服务渠道列表数据 |
| errors | Array | 错误信息列表 |
**data 服务字段说明:**
|| 字段 || 类型 || 说明 ||
| id | Number | 服务渠道ID(用于上传时指定) |
| name | String | 服务渠道名称 |
| code | String | 服务渠道代码 |
|