门店自提接口查不到库存数量,该盯什么
想写盯库存的小工具时,容易先问:门店自提接口能不能查到还剩几台?不能。它只告诉你有没有货、能不能今天取,不给数字。
接口返回了什么
一次门店自提查询的响应里,和库存相关的只有三类信息:
| 字段 | 含义 | 示例值 |
|---|---|---|
pickupDisplay |
该门店该 SKU 的可取状态 | available / unavailable / ineligible |
pickupSearchQuote |
面向用户的提示文案 | 「今天可取货」/「暂无供应」 |
messageTypes.regular.storePickupQuote |
带门店名的文案 | 「今天;某门店名」 |
body.availability 里只有 {"isComingSoon": false},表示是否即将上市,与数量无关。storesCount 是参与查询的门店数,不是库存件数。
接口语义是「可不可以取」,不是「有多少」。剩余件数属零售商内部系统,公开接口不暴露。若 pickupSearchQuote 出现「数量有限」,可抓来做提醒,但仍无具体数字。
为什么数量不对外
可用状态本身是二值结果:系统只判断这家店这个型号当前能否下单自提。数量是内部调度信息,对外暴露等于公开各店备货水平,且数量变化极快,给瞬时数字反而误导。
因此工具目标应从「监控剩余数量」改成「监控状态翻转」。
状态翻转比数量更值得盯
实际观察:某门店 10:31 显示 available「今天可取货」,10:34 已变回无货。窗口只有三分钟,货被下单锁走的速度以分钟计。轮询间隔 15 分钟,整个窗口大概率落在两次查询之间。
对策是压缩发现延迟:
- 缩短轮询间隔。 对目标门店和目标 SKU 单独跑高频查询,比如每分钟一次,而不是把所有门店塞进同一次低频查询。
- 命中后立刻连续确认。 返回
available后连发两三次请求,排除偶发脏数据,确认状态仍稳。 - 状态变化才推送。 只在
pickupDisplay从非available变为available时提醒。
最小判断逻辑:
prev = None
while True:
resp = query_pickup(store_id, sku_id) # 只查一家店一个型号
cur = resp["body"]["pickupDisplay"] # available / unavailable / ineligible
if cur == "available" and prev != "available":
notify(resp["body"]["pickupSearchQuote"])
prev = cur
time.sleep(60)
pickupDisplay 是判断依据,pickupSearchQuote 只是文案,不要拿文案做逻辑判断——文案会变,状态枚举相对稳定。
怎么确认自己没白等
一看日志:记录每次查询的原始 pickupDisplay 和时间戳,事后复盘全靠这份时间线。
二要区分「查询失败」和「确实无货」。请求超时、非 200、响应缺 body,都不能当成 unavailable,否则状态机永远等不到翻转。异常单独计数,连续失败超阈值就报警。
若状态一直是 ineligible,不是没货,是该门店或型号不支持自提,需换目标。
边界和代价
高频轮询有两个约束。一是频率太高易触发限流或风控,返回 429 或被临时拒绝,反而丢窗口;间隔压到一分钟左右通常够用。二是字段结构可能调整,对字段缺失要有兜底,不要假设 pickupSearchQuote 一定存在。
即使一分钟一查,仍可能错过窗口。这是库存释放节奏决定的。工具能做的是把「完全看不见」变成「大概率看得见」,而不是保证抢到。