ASOS 尺码库存查询 API:商品有货,不代表所选尺码有货
isInStock=true——如果补货提醒只看这个字段,用户等的 US 7 可能根本没有货。商品 210916181 的一次库存价格响应确实带着这个值,也带着八个变体;但商品级标记没有回答“其中哪个尺码能买”。问题不在于多请求一次,而在于能否把目标尺码与库存记录可靠地对应起来。
isInStock=true 不能证明目标尺码有货
已观察到的记录属于一款 ASOS DESIGN 棕色皮质孟克鞋。库存价格响应有商品级 isInStock,而同一商品的 v4 详情没有根级 price 或 isInStock。不要让两种响应共用一套“字段不存在就等于缺货”的解析逻辑。
详情的 variants 中能看到 isAvailable;库存价格响应虽然也有八个变体,现有证据却没有确认其变体标识、尺码标签和可用性字段名。不能把详情字段名直接套到库存数组上,也不能仅凭两个数组长度相同,就按下标配对。
美国站库存查询先固定 US、USD、en-US 与美码
把 store=US、currency=USD、lang=en-US、sizeSchema=US 一起保存进监控配置;列表还可传 country=US。这些组合来自国家与店铺配置,不是省略参数后的默认值。sizeSchema 选择尺码体系,不是选择一个尺码;美码 7 不能自动替换成别国标成 7 的鞋。
尚无商品 ID 时,可递归检查分类导航的 children,取商品链接里的 link.categoryId,不要取导航节点自身的 ID。已验证的分类 4209 配合 offset=0、limit=10、sort=freshness 返回了十件商品,其中包含 210916181;商品列表仍要求 categoryId、store、offset、limit。
另一次关键词查询返回空商品数组,不代表分类里也没有货,更不能据此宣布商品下架。q 的说明不建议与 categoryId 合用,而当前列表契约仍要求后者,不能把纯关键词检索视为已验证替代方案。自动补全的 numberOfResults 只是目录匹配数量,不是搜索量或销量。跨站比价还须核对商品身份、统一币种并确认尺码对应关系,不能只比较价格数字。
从八个详情变体中确认要监控的尺码
给商品详情传 id=210916181,同时带上上述地区配置,再检查 variants。这次记录里,displaySizeText=US 7 对应变体 id=210916195、sizeId=388476。商品 ID、变体 ID、尺码 ID 是三个不同值:详情的 id 和库存请求的 productIds 都应继续使用商品 ID。
监控记录应保留尺码标签、变体 ID、尺码 ID及颜色信息,而不是“第一个变体”。八个只是本次详情的数量,不是所有商品的固定尺码数。目标标签找不到、出现多个候选或颜色不一致时,应留下待核对原因;详情的 isAvailable 只能作为该次详情的观察,不能冒充库存响应里尚未核实的变体状态。
如需同类应用的 API,可通过联系页面提出需求,平台也提供源码私有化部署。
在库存价格数组中按 productId 匹配商品 210916181
库存价格接口即使只查一件商品,已观察到的响应主体仍是根数组。应遍历数组,按 productId=210916181 找到唯一匹配项,不要读取假定存在的 data.product,也不要直接取第一项。参数 productIds 虽是复数,契约类型却是数字;当前只验证过单商品请求,没有依据改成逗号分隔的批量值。
下面仅在手动执行时发起读取。把 YOUR_API_KEY 换成你获授权的平台密钥;生产环境从服务端安全配置注入,并在日志中遮蔽查询参数,勿放入公开网页或截图。
curl --get 'https://api.opendata-api.com/api/project/asos/products-v4-get-stock-price?key=YOUR_API_KEY' \
--data-urlencode 'productIds=210916181' \
--data-urlencode 'store=US' \
--data-urlencode 'currency=USD' \
--data-urlencode 'lang=en-US' \
--data-urlencode 'sizeSchema=US'
这不是保证成功的固定响应演示。该次匹配项的 productPrice.current.value 为 94.99,productPrice.currency 为 USD,只代表一次价格观察。HTTP 200 也不等于尺码查询完成:业务错误、主体形状不符或缺少目标商品,都不能进入“已确认有货”路径。
把未知、缺货、有货分开,避免误报补货
接入时先核对真实库存变体的关联键和布尔字段,再编写字段适配器。下面只示范保守的状态判定,不虚构库存变体字段;verified_size_available 是适配器对当前商品、颜色、尺码完成唯一匹配后给出的本地值,不是响应字段。尚未验证映射时保持默认值,结果就是 unknown。
def size_state(rows, product_id, verified_size_available=None):
if not isinstance(rows, list):
return "unknown"
matched = [
row for row in rows
if isinstance(row, dict)
and str(row.get("productId")) == str(product_id)
]
if len(matched) != 1:
return "unknown"
if verified_size_available is True:
return "available"
if verified_size_available is False:
return "unavailable"
return "unknown"
超时、错误响应、缺少字段、未匹配到尺码都属于未知,不是缺货。不要用 bool(value) 把字符串 "false" 转成有货,也不要用字段缺失的默认 False 制造一次假缺货。补货通知只接受同一监控配置下已确认的 unavailable → available;unknown → available 不证明发生过补货。未知记录可进入重试队列,但不覆盖上次已确认状态。
区分 stockLastUpdatedDate 与本次采集时间
该次库存变体出现过 stockLastUpdatedDate=2026-10-23T01:53:27.387Z。这是响应报告的数据时间,不是你收到响应的时间;刚请求成功,也不说明库存刚刚更新。每次另存自己的 UTC observed_at,并保留地区配置、商品与变体身份、三态结果、币种和价格。两类时间分列保存,才能发现重复旧快照,而不是把每次轮询都算成库存变化。
补货轮询、重试间隔和通知去重由应用安排;现有接口没有确立推送能力或固定刷新周期。价格监控同样要积累自己的观察序列,未采集到的时段不能补写成“价格未变”。
接口边界:不能推断库存件数、锁库存或内置历史价格
布尔库存不能换算成“还剩几双”,查询成功也不会锁库存、保留购物车或完成下单。通知只能描述某次已核对的尺码状态,不能承诺用户打开页面时仍可购买。
新接入以 v2 商品列表、v4 详情和 v4 库存价格查询为主;旧版商品列表、早期详情以及 v2/v3 相似商品操作已标记弃用,不能因为旧示例含有某个字段就假定新版兼容。历史价格需要自行保存,跨站比较需要重新核对地区与尺码。若库存变体映射仍未验证,诚实的输出就是“尺码状态待确认”,而不是一条看似完整的补货提醒。