h2. 接口名称
下载模板文件 (Download Template)
h2. 接口地址
{code}
/api/shipper/v1/template/file
{code}
h2. 请求方式
{code}
GET
{code}
h2. 接口描述
该接口用于下载订单上传模板 Excel 文件。用户在上传订单前需要先下载模板,按照模板格式填写订单信息后再上传。
h2. 请求头
|| 参数 || 类型 || 必填 || 说明 ||
| sessionId | String | 是 | 登录会话ID(通过URL参数传递) |
| language | String | 是 | 语言(通过URL参数传递) |
*语言取值:*
|| 值 || 说明 ||
| zh_CN | 中文 |
| en_US | 英文 |
h2. 请求参数
**参数通过 URL 查询参数传递:**
|| 参数 || 类型 || 必填 || 说明 ||
| templateName | String | 是 | 模板名称 |
**templateName 模板名称:**
|| 值 | 说明 |
| parcel_upload_template | 订单上传模板(运单) |
h2. 请求示例
**方式一:直接拼接URL(推荐)**
{code}
curl 'https://tracking-qa.etowertech.com/api/shipper/v1/template/file?language=zh_CN&sessionId=vP1l43F_OqvoTUWBcaAtyg&templateName=parcel_upload_template' \
-O
{code}
h2. 返回说明
*响应类型:* application/vnd.openxmlformats-officedocument.spreadsheetml.sheet(Excel文件)
*响应头:*
|| 参数 || 说明 ||
| Content-Disposition | 文件名,如:attachment; filename=parcel_upload_template.xlsx |
| Content-Type | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| Content-Length | 文件大小 |
*返回说明:*
- 返回的是 Excel 文件流(.xlsx 格式)
|