查阅 ASOS 已弃用的分类商品列表接口与迁移要求
查看 ASOS 商品搜索、价格与尺码库存 API 的全部接口 →此分类商品列表接口已弃用,仅供旧版集成迁移参考。categoryId 取自分类查询,store 使用国家记录中的 siteId,同时必须提供 offset 和 limit。可通过 country、currency、lang 和 sizeSchema 指定地区环境,通过 brand、size、base_colour 及属性筛选条件缩小分类范围;min 和 max 是文档中定义为整数的价格上下限。文档列出的排序值为 freshness、priceasc 和 pricedesc。此旧版接口未声明 q 参数,不能据此认为它具备新版列表的关键词搜索能力。系列、颜色、品牌和尺码等筛选值的说明引用了 facetValues[].id。目前没有此已弃用接口的响应示例或成功测试记录,因此商品字段、响应结构、分页元数据及接口是否仍可用均未得到验证。迁移至 /products/v2/list 时,应逐项核对 min/max 与 priceMin/priceMax 的对应关系,并重新检查已保存的筛选条件,不要把新旧路径当作可直接互换的别名。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/asos/products-list-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/asos/products-list-deprecated?key=<API_KEY>&categoryId=<categoryId>&limit=<limit>&offset=<offset>&store=<store>'
查询结果
使用场景
- 盘点仍通过 /products/list 采集分类商品的程序,在迁移前记录各自的 categoryId、store、offset 和 limit 设置。
- 编制价格筛选迁移清单,将旧版 min/max 的使用意图对应到新版 priceMin/priceMax,而不假定两者返回结果完全一致。
- 保留原有地区设置,检查已保存的品牌、尺码、颜色和属性筛选项是否使用了过期的分面 ID。
- 仅在旧版仍可访问时安排新旧分类结果的受控对比;由于旧版未声明 q 输入,关键词搜索测试应单独进行。
常见问题
新建分类浏览功能应该使用这个已弃用接口吗?
应优先评估当前的 /products/v2/list 接口。此旧版路径仅保留用于迁移参考,没有提供成功测试记录或响应示例。
旧版商品列表有哪些必填参数?
categoryId、store、offset 和 limit 均为必填项。categoryId 来自分类查询,store 则使用相应国家记录中的 siteId。对比旧请求时,应明确记录所用的地区和分页设置。
可以通过 q 参数传入关键词吗?
所提供的旧版接口定义没有声明 q。不要自行添加该参数,也不要承诺与新版关键词搜索等效;如需搜索,应另行评估当前商品列表接口文档列出的搜索输入。
旧版价格筛选参数也叫 priceMin 和 priceMax 吗?
不是。此接口声明的是 min 和 max,均为数值类型,文档将其定义为整数价格边界。新版列表使用 priceMin 和 priceMax,迁移时需要显式核对这组字段的对应关系。
筛选 ID 从哪里获取?响应字段是否经过验证?
参数说明引用 facetValues[].id 作为系列、颜色、品牌和尺码的筛选选项,并说明多项筛选可重复传入相同查询键。但此处没有响应样例或成功测试记录,因此响应结构、商品字段及重复传参的实际行为都尚未验证。