查询 ASOS 商品详情、图片与尺码规格
查看 ASOS 商品搜索、价格与尺码库存 API 的全部接口 →使用商品列表返回的数字商品 id,查询 ASOS 商品详情。id 为必填参数;可选的 currency、lang、sizeSchema 和 store 应使用国家信息查询返回的对应值。store 需要填写店铺市场代码,不要使用商品列表接口中的 site 站点标识。一次成功的 HTTP 200 验证使用了 id=210916181、store=US、currency=USD、lang=en-US 和 sizeSchema=US。 该次响应为对象,包含与请求一致的商品 id,以及 name、description、productCode、gender、brand、productType、info、media、localisedData、尺码相关标记和 variants。示例商品为棕色皮革孟克鞋,brand.id=53、brand.name=ASOS DESIGN、gender=Men、productType.name=Shoes。info 包含 aboutMe、sizeAndFit 和 careInfo。media.images 有四条图片记录,包含 url、type、colourWayId、colour 和 isPrimary;其他媒体集合可能为空。 该商品返回了八个规格,包含 id、sizeId、brandSize、displaySizeText、sizeOrder、sku、isAvailable、colourWayId 和 colour。例如,规格 210916195 的 sizeId 为 388476,displaySizeText 为 US 7;这些标识与商品 id 210916181 不同。localisedData 包含 locale、title 和 pdpUrl 记录。此次响应中的 rating、shippingRestriction 和 fitType 等可选字段为 null,解析时应兼容字段缺失、空值及数组长度变化。 已验证的 v4 详情对象在根层级没有 price 或 isInStock 字段。另一份截断示例中出现过 price、isInStock、alternateNames 和 brand.brandId,但本次 v4 记录未确认这些字段。需要价格或库存状态时,请使用独立的库存与价格查询接口;详情中的规格数据不提供精确库存数量、保证的刷新周期或内置价格历史。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/asos/products-v4-detail API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/asos/products-v4-detail?key=<API_KEY>&id=<id>'
查询结果
使用场景
- 为商品 210916181 构建鞋类详情查看页,展示已验证的 ASOS DESIGN 品牌、Shoes 分类、养护说明、四张图片及八个尺码规格。
- 解读独立库存响应前,先将关注的 US 7 等尺码对应到返回的规格 ID 和 sizeId,避免把商品 ID 或数组下标当作尺码标识。
- 根据品牌、性别、商品类型和描述筛选内部商品匹配候选项,同时区分 ASOS 商品 ID 与通用零售商品标识。
- 由应用单独缓存商品描述等元数据,与定期库存、价格检查分开刷新;刷新策略由应用制定,不假设详情数据有保证的有效期。
常见问题
哪些 ASOS 商品和地区参数已成功验证?
已有成功记录使用商品 id 210916181,搭配 store=US、currency=USD、lang=en-US 和 sizeSchema=US,返回 HTTP 200。该商品为 ASOS DESIGN 男款棕色皮革孟克鞋。单次记录不能证明其他商品或地区参数组合也具有相同表现。
id 和可选的地区参数从哪里获取?
数字商品 id 来自商品列表;currency、lang、sizeSchema 和 store 使用国家信息查询返回的对应值。store 应填写 US 等店铺市场代码,而不是商品列表使用的 site 站点标识。只有 id 为必填参数。
v4 详情响应包含当前价格和精确库存数量吗?
已验证的 v4 详情对象在根层级没有 price 或 isInStock 字段。规格中虽然包含 isAvailable,但这个布尔值不表示库存数量。请使用独立的库存与价格查询接口获取相关记录;本详情响应和已有示例均未证明支持精确库存数量或内置价格历史。
如何识别某个具体尺码,而不是整件商品?
检查每个规格返回的 id、sizeId、brandSize 和 displaySizeText。示例商品 210916181 包含规格 210916195,其 sizeId 为 388476,displaySizeText 为 US 7。这些是不同的标识,数组位置也不能作为稳定的尺码标识。
每件商品都会返回八个规格和四张图片吗?
不会。这些数量只是在一个鞋类商品中观察到的结果。应逐条读取各商品实际返回的数组,允许媒体集合为空,并兼容 rating、shippingRestriction、fitType 等字段为 null 的情况。
应该按旧示例解析 brandId 和 alternateNames 吗?
不应将它们视为已确认的 v4 字段。已验证记录使用 brand.id 和 brand.name,并在 localisedData 中返回 locale、title、pdpUrl。brand.brandId 和 alternateNames 仅出现在另一份截断示例中,应以实际输出验证字段,而不是直接沿用旧名称。
商品描述可以与库存检查分开缓存吗?
可以。应用可将返回的商品描述、品牌、图片和尺码元数据单独保存,与定期获取的库存、价格记录分开管理。缓存时长和刷新策略由应用决定;现有验证信息未证明接口提供内置缓存、保证的元数据有效期或更新周期。