Skip to main content
GET
Get return inventory by line item ID
此頁面由 AI 自動翻譯。API 技術規格以英文呈現為標準。如有任何疑問,請參閱英文版本
依特定退貨申請行項目 ID 取得相關的退件庫存記錄。當您已從退貨申請中取得行項目參照、需要庫存目前狀態時使用。

庫存圖片

回應中每筆庫存紀錄都包含 returnRequestLineItemImages[] 陣列,列出附加到 line item 上的圖片。此端點回傳的是 S3 key,而非 URL —— 要顯示或下載圖片,請以您所在環境的主機名稱與 key 串接出 URL。

條目結構

每筆紀錄提供同一張圖片的四種尺寸變體,方便您按 UI 用途選用:

構造 URL

依環境選擇主機名稱: 公式:
生產環境範例:
key 已經包含完整的 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