Skip to main content
GET
Get return inventory by line item ID
このページはAIによって自動翻訳されています。API技術仕様は英語が正式です。不明点がある場合は英語版を参照してください。
特定の返品リクエスト・ラインアイテム ID に紐づく返品在庫レコードを取得します。返品リクエストからラインアイテム参照を取得し、その在庫状態が必要な場合に使用してください。

在庫画像

レスポンスの各在庫レコードには、line item に紐づく画像を列挙する returnRequestLineItemImages[] 配列が含まれます。このエンドポイントは URL ではなく S3 キーを返します — 画像を表示・取得するには、お客様の環境のホスト名と S3 キーを連結して URL を組み立ててください。

エントリの構造

各エントリは同一画像の 4 つのサイズ別バリアントを返却するため、UI の用途に応じて適切なものを選択できます:

URL の組み立て方

環境ごとのホスト名: 組み立てる式:
本番環境の例:
キーには S3 の完全なパスがすでに含まれています。組み立てた URL は公開アクセス可能で、認証ヘッダー不要、かつ期限切れもありません。URL と画像コンテンツの両方をクライアント側で安全にキャッシュできます。
パスは不透明なものとして扱ってください。 Return Helper は過去に複数のパスプレフィックス(img/returns/...images/returns/... など)を使用してきました。ホスト名のみが安定です。パスやファイル名を解析・検証・パターンマッチしないでください。
このエンドポイントの空状態:returnRequestLineItemImages: null返品在庫詳細を取得 エンドポイントでは [])。いずれも「画像なし」として扱ってください。
このエンドポイントは問い合わせ時点の現在状態を返します。倉庫担当者が画像を追加・置換・削除したタイミングでリアルタイム通知が必要な場合は、このエンドポイントをポーリングするのではなく changeLineItemImage webhook を購読してください。

関連

承認

x-rr-apikey
string
header
必須

Your API key

x-rr-apitoken
string
header
必須

Your API token — keep this private

クエリパラメータ

lineItemId
integer<int64>

Return request line item identifier

レスポンス

Success

returnInventoryId
integer<int64>

Return inventory identifier