接口名称
下载模板文件 (Download Template)
接口地址
/api/shipper/v1/template/file
请求方式
GET
*重要说明：* 该接口通过浏览器导航方式下载文件（`window.open`），参数通过 *URL 查询参数* 传递。
接口描述
该接口用于下载订单上传模板 Excel 文件。用户在上传订单前需要先下载模板，按照模板格式填写订单信息后再上传。
请求头
参数 |
类型 |
必填 |
说明 |
|---|---|---|---|
sessionId |
String |
是 |
登录会话ID（通过URL参数传递） |
language |
String |
是 |
语言（通过URL参数传递） |
语言取值：
值 |
说明 |
|---|---|
zh_CN |
中文 |
en_US |
英文 |
请求参数
*参数通过 URL 查询参数传递：*
参数 |
类型 |
必填 |
说明 |
|---|---|---|---|
templateName |
String |
是 |
模板名称 |
*templateName 模板名称：*
值 |
说明 |
|---|---|
parcel_upload_template |
订单上传模板（运单） |
请求示例
*方式一：直接拼接URL（推荐）*
curl 'https://tracking-qa.etowertech.com/api/shipper/v1/template/file?language=zh_CN&sessionId=vP1l43F_OqvoTUWBcaAtyg&templateName=parcel_upload_template' \ -O
返回说明
响应类型： 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 格式）