获取面单（PDF）

接口说明

按 WMG 单号获取包裹面单，返回PDF 文件的 Base64 编码内容。

请求信息

• 方法：GET
• 路径：/openapi/order-shipping-label/get-shipping-label
• 认证方式：标准 OpenAPI token（基于 MD5）

请求头

字段	说明
Content-Type	application/json
x-auth-name	$API_NAME
x-auth-seed	$SEED（13 位毫秒级 UNIX 时间戳）
x-auth-token	$TOKEN（MD5 哈希）

请求参数

参数	类型	必填	说明
tracking_num	string	是	WMG 包裹单号

Token 生成说明

token 只由凭证和 seed 计算得出 —— 请求参数不参与。

seed  = "1746700000000"   （13 位毫秒时间戳）
token = md5( strtolower(api_name) + api_key + seed )

认证

本接口使用标准 OpenAPI 认证（MD5 token）。

完整的认证说明与多语言示例见认证与签名。

响应信息

响应为 JSON 格式。

响应结构

字段	类型	说明
code	integer	结果码。0 = 成功，1 = 失败
message	string	结果描述
data	object	响应数据

成功响应

• HTTP 状态码：200

{
    "code": 0,
    "message": "success",
    "data": {
        "base64": "JVBERi0xLjcKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWJRFs8NTJkNTBjMzZkMjQ4ODFjMDVkYTM4NGQxODg2ODU2Yzc+PDUyZDUwYzM2ZDI0ODgxYzA1ZGEzODRkMTg4Njg1NmM3Pl0KPj4Kc3RhcnR4cmVmCjg5NTQ3CiUlRU9GCg=="
    }
}

字段	类型	说明
data.base64	string	PDF 文件的 Base64 编码内容

失败响应

• HTTP 状态码：200（业务错误）或 4xx/5xx（系统错误）

{
    "code": 1,
    "message": "Order Not Found!",
    "data": []
}

常见错误：

• 认证失败 → code 1；具体 message 取决于失败原因（如 x-auth-token: INVALID、x-auth-seed: TIMEOUT）—— 见认证与签名
• 单号不存在 → code 1，message 为 Order Not Found!

结果码

Code	说明
0	成功
1	失败

调用示例

Bash

API_NAME="your_api_name"
API_KEY="your_api_key"
SEED=$(date +%s%3N)
TOKEN=$(printf '%s' "$(echo -n "$API_NAME" | tr '[:upper:]' '[:lower:]')${API_KEY}${SEED}" | md5sum | cut -d' ' -f1)

# Fetch label and decode to PDF
curl -G "https://api.test.wmgdelivery.com/v1/openapi/order-shipping-label/get-shipping-label" \
  --data-urlencode "tracking_num=WMG1234567" \
  -H "x-auth-name: $API_NAME" \
  -H "x-auth-seed: $SEED" \
  -H "x-auth-token: $TOKEN" \
  | python3 -c "import sys,json,base64; d=json.load(sys.stdin); open('label.pdf','wb').write(base64.b64decode(d['data']['base64']))"

Windows PowerShell

$API_NAME = "your_api_name"
$API_KEY  = "your_api_key"
$SEED     = [string]([DateTimeOffset]::UtcNow.ToUnixTimeMilliseconds())

$raw   = [System.Text.Encoding]::UTF8.GetBytes($API_NAME.ToLower() + $API_KEY + $SEED)
$md5   = [System.Security.Cryptography.MD5]::Create().ComputeHash($raw)
$TOKEN = -join ($md5 | ForEach-Object { $_.ToString("x2") })

$headers = @{
    "x-auth-name"  = $API_NAME
    "x-auth-seed"  = $SEED
    "x-auth-token" = $TOKEN
}

$response = Invoke-RestMethod `
    -Uri "https://api.test.wmgdelivery.com/v1/openapi/order-shipping-label/get-shipping-label?tracking_num=WMG1234567" `
    -Method Get -Headers $headers

# Decode Base64 and save as PDF
[System.IO.File]::WriteAllBytes("label.pdf", [Convert]::FromBase64String($response.data.base64))
Write-Host "Label saved to label.pdf"

Python

import hashlib, time, base64
import requests

API_NAME = 'your_api_name'
API_KEY  = 'your_api_key'
SEED     = str(int(time.time() * 1000))
TOKEN    = hashlib.md5((API_NAME.lower() + API_KEY + SEED).encode()).hexdigest()

headers = {
    'x-auth-name':  API_NAME,
    'x-auth-seed':  SEED,
    'x-auth-token': TOKEN,
}

resp = requests.get(
    'https://api.test.wmgdelivery.com/v1/openapi/order-shipping-label/get-shipping-label',
    params={'tracking_num': 'WMG1234567'},
    headers=headers,
)
data = resp.json()
if data['code'] == 0:
    with open('label.pdf', 'wb') as f:
        f.write(base64.b64decode(data['data']['base64']))
    print('Label saved to label.pdf')
else:
    print('Error:', data['message'])

Node.js / TypeScript

import crypto from 'node:crypto';
import fs from 'node:fs';

const API_NAME = 'your_api_name';
const API_KEY  = 'your_api_key';
const SEED     = String(Date.now());
const TOKEN    = crypto.createHash('md5').update(API_NAME.toLowerCase() + API_KEY + SEED).digest('hex');

const url = new URL('https://api.test.wmgdelivery.com/v1/openapi/order-shipping-label/get-shipping-label');
url.searchParams.set('tracking_num', 'WMG1234567');

const resp = await fetch(url.toString(), {
    headers: {
        'x-auth-name':  API_NAME,
        'x-auth-seed':  SEED,
        'x-auth-token': TOKEN,
    },
});
const data = await resp.json() as { code: number; data: { base64: string } };
if (data.code === 0) {
    fs.writeFileSync('label.pdf', Buffer.from(data.data.base64, 'base64'));
    console.log('Label saved to label.pdf');
}

PHP

<?php
$API_NAME = 'your_api_name';
$API_KEY  = 'your_api_key';
$SEED     = (string)(time() * 1000);
$TOKEN    = md5(strtolower($API_NAME) . $API_KEY . $SEED);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.test.wmgdelivery.com/v1/openapi/order-shipping-label/get-shipping-label?' . http_build_query(['tracking_num' => 'WMG1234567']));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'x-auth-name: '  . $API_NAME,
    'x-auth-seed: '  . $SEED,
    'x-auth-token: ' . $TOKEN,
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
if ($data['code'] === 0) {
    file_put_contents('label.pdf', base64_decode($data['data']['base64']));
    echo "Label saved to label.pdf\n";
} else {
    echo 'Error: ' . $data['message'] . "\n";
}
?>

注意事项

• 保存或打印前，先用标准 Base64 解码 data.base64 得到原始 PDF 字节。
• 认证 token 不包含请求参数，只用凭证和 seed 计算。
• x-auth-seed 必须是 13 位毫秒级 UNIX 时间戳，且与服务器时间相差不超过 ±10 分钟。
• 所有参数区分大小写。

错误码

code	message	说明
1	认证错误消息	认证失败；具体 message 取决于失败原因 —— 完整清单见认证与签名
1	Order Not Found!	当前客户下不存在该 tracking_num 对应的订单
1	承运商接口错误	面单生成链路（Singpost / Spring / PDF 生成）返回错误时透传，message 文本来自承运商服务