Skip to main content
GET
Get return inventory details
此页面由 AI 自动翻译。API 技术规格以英文呈现为标准。如有任何疑问,请参阅英文版本
依据 returnInventoryId 获取单条退件库存记录的完整内容。常在收到 webhook(例如 inventoryCreated)后调用,以读取当前状态。

库存图片

响应中包含 returnRequestLineItemImages[] 数组,列出附加到库存对应行项目上的图片。该端点返回的是 S3 key,而不是 URL —— 要展示或拉取图片,请用您所在环境的主机名与 key 拼接出 URL。

条目结构

每条记录提供同一张图片的四种尺寸变体,便于您按 UI 用途选用:

构造 URL

按环境选择主机名: 公式:
生产环境示例:
key 已经包含完整的 S3 路径。拼接出来的 URL 公网可访问,不需要认证头,也不会过期;URL 与图片内容均可在客户端安全缓存。
请将路径视为不透明。 Return Helper 历史上使用过多种路径前缀(例如 img/returns/...images/returns/...);只有主机名是稳定的。请勿解析、校验或对路径/文件名做任何模式匹配。
无图片时的空状态:returnRequestLineItemImages: []
本端点返回的是查询那一刻的当前状态。如需在仓库人员添加、替换或删除图片时实时收到通知,请订阅 changeLineItemImage webhook,而非反复轮询本端点。

相关

授权

x-rr-apikey
string
header
必填

Your API key

x-rr-apitoken
string
header
必填

Your API token — keep this private

查询参数

returnInventoryId
integer<int64>

Return inventory identifier

响应

Success

returnInventoryId
integer<int64>

Return inventory identifier