建立配送標籤
為指定的物流業者和貨件詳情建立配送標籤。支援冪等建立 — 使用相同 idempotencyKey 重送請求將以 HTTP 200 返回原始結果,而不建立重複標籤。
授權
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
主體
建立配送標籤的請求酬載。
建立配送標籤的請求酬載。
客戶端產生的唯一金鑰,用於確保冪等標籤建立。使用相同金鑰重送請求將返回原始結果。
1 - 100"unique-key-per-request"
要使用的物流業者代碼。呼叫 GET /couriers 以列出您帳戶可用的有效物流業者代碼,然後傳入其中一個返回的 code 值。
1"yunexpress"
物流業者服務設定。
包含發件地、目的地及包裹的貨件詳情。
標籤輸出偏好設定。
重量與尺寸的計量單位。
訂單參考資訊。
跨境貨件的報關資訊。
以代碼與值配對方式提供的額外服務選項。
危險品申報。
取件點設定。
物流業者專屬選項。
回應
標籤建立請求的結果。
標籤建立請求的結果。
唯一標籤識別碼。
"f47ac10b-58cc-4372-a567-0e02b2c3d479"
標籤建立結果 — created 或 failed。
created "created"
使用的物流業者。
"yunexpress"
與此標籤關聯的客戶訂單編號。
"N-2026-05-27-TEST-03"
物流業者指派的訂單編號,失敗時為 null。
"YT2503010001"
物流業者指派的追蹤編號,尚未取得時為 null。
"YT2503010001CN"
標籤建立失敗時的錯誤詳情,否則為 null。