想写盯库存的小工具时,容易先问:门店自提接口能不能查到还剩几台?不能。它只告诉你有没有货、能不能今天取,不给数字。

接口返回了什么

一次门店自提查询的响应里,和库存相关的只有三类信息:

字段 含义 示例值
pickupDisplay 该门店该 SKU 的可取状态 available / unavailable / ineligible
pickupSearchQuote 面向用户的提示文案 「今天可取货」/「暂无供应」
messageTypes.regular.storePickupQuote 带门店名的文案 「今天;某门店名」

body.availability 里只有 {"isComingSoon": false},表示是否即将上市,与数量无关。storesCount 是参与查询的门店数,不是库存件数。

接口语义是「可不可以取」,不是「有多少」。剩余件数属零售商内部系统,公开接口不暴露。若 pickupSearchQuote 出现「数量有限」,可抓来做提醒,但仍无具体数字。

为什么数量不对外

可用状态本身是二值结果:系统只判断这家店这个型号当前能否下单自提。数量是内部调度信息,对外暴露等于公开各店备货水平,且数量变化极快,给瞬时数字反而误导。

因此工具目标应从「监控剩余数量」改成「监控状态翻转」。

状态翻转比数量更值得盯

实际观察:某门店 10:31 显示 available「今天可取货」,10:34 已变回无货。窗口只有三分钟,货被下单锁走的速度以分钟计。轮询间隔 15 分钟,整个窗口大概率落在两次查询之间。

对策是压缩发现延迟:

  1. 缩短轮询间隔。 对目标门店和目标 SKU 单独跑高频查询,比如每分钟一次,而不是把所有门店塞进同一次低频查询。
  2. 命中后立刻连续确认。 返回 available 后连发两三次请求,排除偶发脏数据,确认状态仍稳。
  3. 状态变化才推送。 只在 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 一定存在。

即使一分钟一查,仍可能错过窗口。这是库存释放节奏决定的。工具能做的是把「完全看不见」变成「大概率看得见」,而不是保证抢到。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注