查询 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 功能

商品身份与分类信息补全 根据列表中的商品 ID,读取已验证的 id、name、productCode、gender、brand.id、brand.name 和 productType 字段,完善商品目录查看记录。
尺码与规格标识对应 查看规格 id、sizeId、brandSize、displaySizeText、sizeOrder、sku 和颜色信息;已验证的鞋类商品返回了八个规格。
商品图片与养护内容读取 结合 media.images、description 及 info.aboutMe、info.sizeAndFit、info.careInfo 展示商品内容;已验证的商品包含四条图片记录。
本地化详情记录解析 读取已验证的 localisedData 中的 locale、title 和 pdpUrl,并使用国家信息查询返回的参数设置请求市场与尺码体系。
详情字段与库存价格分开处理 将描述性商品记录与库存、价格查询结果分开使用:已确认的 v4 详情在规格中包含 isAvailable,但根层级没有 price 或 isInStock。

在线 API 演示

GET /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>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

哪些 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 仅出现在另一份截断示例中,应以实际输出验证字段,而不是直接沿用旧名称。

商品描述可以与库存检查分开缓存吗?

可以。应用可将返回的商品描述、品牌、图片和尺码元数据单独保存,与定期获取的库存、价格记录分开管理。缓存时长和刷新策略由应用决定;现有验证信息未证明接口提供内置缓存、保证的元数据有效期或更新周期。

相关接口

相关指南

查看订阅方案 →