核查已弃用的 ASOS v2 相似商品查询接口约定
查看 ASOS 商品搜索、价格与尺码库存 API 的全部接口 →此相似商品查询接口已弃用,保留文档用于排查旧版推荐功能的接口依赖。必填参数 id 为数字,应取自 /products/v2/list 返回的商品;可选字符串参数 store 取自 /countries/list。文档中的 id 示例为 9851612,store 示例为 US,但这些示例不能证明商品目前仍可售。此接口没有成功的实测响应可供核对。未经验证且不完整的文档响应示例包含根级 id 和 products 数组,数组条目包含 order 与嵌套的 product。示例商品字段包括 id、name、brandName、colour、images、isAvailable、isInStock、productCode、price 和 variants。price 中列出 currency、current、previous、rrp、isMarkedDown 和 isOutletPrice,其中 current 包含 text 和 value;示例规格字段包括 id、brandSize、sizeId、sizeOrder、isAvailable、isInStock 和 isLowInStock。这些字段仅供理解示例,不能视为已验证的当前响应约定,也不表示库存数量或有明确定义的相似度分数。请勿假定此路径仍能返回推荐结果,也不要把其他已列出的接口当作等价替代。若要改为应用自行推荐,可通过当前商品列表获取候选商品,再单独查询详情,并明确说明商品筛选逻辑由应用自行制定。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/asos/products-v2-list-similarities-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/asos/products-v2-list-similarities-deprecated?key=<API_KEY>&id=<id>'
查询结果
使用场景
- 排查仍调用 /products/v2/list-similarities 的旧版关联商品组件,在重新设计前将该依赖标记为已弃用。
- 整理现有推荐流程中的种子商品 ID 和可选店铺代码,明确其对特定商品及地区市场的依赖。
- 参照未经验证的 order 与 product 示例结构检查归档响应的解析逻辑,而不将示例视为接口仍可用的证据。
- 利用当前列表候选商品与详情数据尝试自建关联商品筛选,并与归档推荐结果比较,同时明确不声称两者具有等价的相似度分数。
常见问题
必填参数 id 表示什么?
它是 /products/v2/list 返回的数字商品 ID,不是分类 ID 或规格 ID。文档以 9851612 为例,但没有验证该商品目前是否可售,也没有确认这个已弃用的查询接口仍可用。
已弃用的相似商品查询必须传 store 吗?
不必。store 是可选的字符串代码,应从 /countries/list 获取,文档示例为 US。现有资料没有实测省略该参数时的行为,因此不要假定接口采用某个默认地区。
文档列出了什么响应结构,是否经过实测?
不完整且未经验证的文档示例列出了根级 id 和 products 字段,每个 products 条目包含 order 和 product。嵌套商品示例涵盖商品标识、图片、价格、可用性和规格字段。此接口没有成功的实测响应,因此这些字段不能视为已验证的当前响应约定。
order 是有明确定义的相似度分数吗?
不是。现有资料没有提供相似度分数的定义。虽然示例中存在 order 字段,但它不能证明接口采用某种数值相似度指标、排序稳定,或不同店铺会返回等价推荐。
是否已有确认可用的现行替代接口?
现有证据没有确认等价的现行相似商品接口。可以评估当前商品列表和详情数据是否适合用于自建推荐规则,但这属于应用自行筛选,不能直接作为等价替代。
示例中的可用性标记能当作准确库存数量吗?
不能。isAvailable、isInStock 以及规格中的 isLowInStock 只是未经验证示例中的状态标记,不是库存数量,也不保证当前可售。涉及库存的流程应另行参考有独立文档说明的库存查询结果。