下载POD文件

接口

http://dmsqa.xiyou56.com/v1/open-api/downloadPOD

method

POST

Header

参数 是否必填 说明
x-lt-openKeyId 必填 访问用户隐私数据时的唯一权限标识 openKeyId
x-lt-signature 必填 接口签名 签名规则

请求示例

  • BODY
{
    "trackingNumbers": [
        "ZX10241525",
        "ZX10241524"
    ]
}

请求参数：

参数 类型 是否必填 说明
trackingNumbers list 是 多个跟踪号(最多50条)

响应示例

参数 类型 说明
code int 响应码
success boolean true：成功，false:失败
data object 响应数据
msg String 响应说明
error String 错误信息
  • data 说明
参数 类型 说明
trackingNumber String 跟踪号
podUrl String 对应POD下载地址

成功示例

{
    "code": 200,
    "success": true,
    "msg": "success",
    "data": [
        {
            "trackingNumber": "ZX10241524",
            "podUrl": "https://storage.googleapis.com/xywl-dms-files-bucket/upload/20260113/85f1b1956232a1767cf5ddb30e4a605c.pdf?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=developer%40wpglb-4006-618-718.iam.gserviceaccount.com%2F20260119%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20260119T021659Z&X-Goog-Expires=86400&X-Goog-SignedHeaders=host&X-Goog-Signature=63d377912c0cc4825276dd52b4df29d64c6c9ef6a7370046514024103811c42f0f7065285714c450246fef30839d17c82086fc251baf71540ff135163372849729efd4f5056fa1c067edcd4e9e025fa232c1bf9907aef2a852c53f283e21e7eb4dd91b4c32e874f23daa5dfae99ab1e2bd2ff7e47387b0522650e1d66fc09856c4539718752222bb848bc7eaf7c8b13e101756c44893c685e5899146dd6a4b06633ac1f38aeff91ed7ac22fc2767d5153bd31f35149e37dedb13fd9071dfe8d5d3578d3d840907b44b381334259a342bfa5dc8776702ee915bcf42d38be76792200194a076c600349f8add9d65157881f0ebb7d0d5a6be13541a734c3c44c428"
        },
        {
            "trackingNumber": "ZX10241525",
            "podUrl": "https://storage.googleapis.com/xywl-dms-files-bucket/upload/20260113/eb353c943a8023aef0dc1f44e7e8cdef.pdf?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=developer%40wpglb-4006-618-718.iam.gserviceaccount.com%2F20260119%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20260119T021701Z&X-Goog-Expires=86400&X-Goog-SignedHeaders=host&X-Goog-Signature=8d1c8bf7ada6294eda6d2581350a44eb0eab68546fa14a8fe5cd7be3c1a00ccd6bf6352aaaa32b59bbab5424210efe91458bef774e31ac52a9ae41b9a93c3fd795a4c588e08ddfa658d8cc95ec0039dce1dc867c6996e67223ee8050840a7e5d54de757ec1935bb4edc1e11b7aed294aeea6e203b9e5c9da6e1169df91b96e14ac97859d3487f60bdd1cc4f987639d4fa2fc8fd836ff751c9c9799c96b6aea781a9a1e74fe1d3dbaa90ecc60ad7a14fbf55e5def0c1afee14912076a64fe32efcfb90bd40cc647181910afa16808430949960794b4875f33e8b9251c30789c1784aff381139e4053050187d9dab1c111fa6e60cb06103660de3a50704d5d1286"
        }
    ],
    "error": ""
}

失败示例

{
    "code": 500,
    "success": false,
    "msg": "未找到该跟踪号的POD文件",
    "data": "",
    "error": "未找到该跟踪号的POD文件"
}
{
    "code": 500,
    "success": false,
    "msg": "单次最多查询50个跟踪号",
    "data": "",
    "error": "单次最多查询50个跟踪号"
}

鉴权示例

{
    "code": 401,
    "success": false,
    "msg": "认证失败",
    "data": "",
    "error": "认证失败"
}
作者：陈杨  创建时间：2026-01-06 16:55
最后编辑：陈杨  更新时间：2026-03-03 10:08