メインコンテンツへスキップ
このページは英語から翻訳されています。英語版が正式な情報源です。翻訳内容に不一致がある場合は、英語版を参照してください。

​
ラベルドキュメントを取得する

配送ラベルを作成した後、GET /labels/{id}を使用して印刷可能なエアウェイビルドキュメントを取得します。単一の識別子またはカンマ区切りの識別子を渡してバッチ取得できます。このガイドでは、取得フロー、バッチリクエスト、ドキュメント形式、および実用的な考慮事項について説明します。

​
ドキュメントURLを取得する

ラベル作成レスポンスのidを使用します： 
curl https://api.flexforward.com/labels/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
レスポンス

200 OK
{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "customerOrderNumber": "N2026-05-13-TEST-01",
  "url": "https://label-cdn.yunexpress.cn/labels/YT2503010001.pdf",
  "labelFormat": "pdf"
}
フィールド説明
idラベルのUUID（リクエストパラメータと同じ）。
customerOrderNumberこのラベルに関連付けられた顧客注文番号。
urlエアウェイビルドキュメントの直接ダウンロードURL。
labelFormatドキュメント形式：pdfまたはpng。

​
ダウンロードして印刷する

返されたurlからドキュメントをダウンロードします： 
curl -o label.pdf "https://label-cdn.yunexpress.cn/labels/YT2503010001.pdf"

​
ドキュメントの動作

  • 永続URL — ドキュメントURLは有効期限がありません。URLを保存して、いつでもドキュメントをダウンロードできます。
  • 形式 — ドキュメントは、配送業者とラベル設定に応じて、PDFまたはPNGで提供されます。
  • 再取得 — GET /labels/{id}を複数回呼び出しても、同じURLが返されます。このエンドポイントは本質的にべき等です。

​
バッチ取得

カンマ区切りの識別子を渡すことで、1回のリクエストで複数のラベルドキュメントを取得できます。ラベルUUIDと顧客注文番号を混在させることができます。 
curl "https://api.flexforward.com/labels/f47ac10b-58cc-4372-a567-0e02b2c3d479,N2026-05-13-TEST-02" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
バッチレスポンス

200 OK
{
  "labels": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "customerOrderNumber": "N2026-05-13-TEST-01",
      "url": "https://label-cdn.yunexpress.cn/labels/YT2503010001.pdf",
      "labelFormat": "pdf"
    },
    {
      "id": "c8d9e0f1-2345-6789-abcd-ef0123456789",
      "customerOrderNumber": "N2026-05-13-TEST-02",
      "url": "https://label-cdn.yunexpress.cn/labels/YT2503010002.pdf",
      "labelFormat": "pdf"
    }
  ]
}
フィールド説明
labels正常に解決されたラベルドキュメントの配列。見つからないまたは失敗したラベルは省略されます。
labels[].idラベルのUUID。
labels[].customerOrderNumberこのラベルに関連付けられた顧客注文番号。
labels[].urlエアウェイビルドキュメントの直接ダウンロードURL。
labels[].labelFormatドキュメント形式：pdfまたはpng。
見つからないまたは失敗したラベルはレスポンスから暗黙的に省略されます。返されたlabels配列をリクエストした識別子と比較して、解決されなかったものを検出してください。

​
エラーハンドリング

ステータス意味アクション
200ドキュメントURLを取得しましたurlフィールドからダウンロードしてください
403アクセス拒否ラベルが別のアカウントに属しています
404ラベルが見つかりませんラベルIDが正しいか確認してください
502上流サービスエラーエクスポネンシャルバックオフでリトライしてください

​
次のステップ

出荷を追跡する

ラベルを印刷して荷物に貼付した後、出荷状況を監視します。

エラーハンドリング

すべてのHTTPステータスコードとエラーレスポンス形式の完全なリファレンス。