DigiKey 芯片库存监控：API 库存、价格与交期怎么判断

先说结论

DigiKey 芯片库存监控的核心不是不断刷新搜索结果，而是用完整制造商订货型号（MPN）调用 Product Information API，保存带时间的库存、价格和交期结果。身份认证成功并不等于每个型号都可见；授权、区域、速率限制和网络异常都必须与 OUT_OF_STOCK 分开。

适用范围

本文适合采购、研发和供应链团队，需要定时复核 DigiKey 型号是否可买、价格档位如何变化，以及交期是否拉长。它是监控与取证方法，不是 DigiKey 的供货承诺，也不替代下单前的商品页和商业条款确认。平台实际能否运行该渠道，仍以管理员启用状态和有效 API 凭证为准。

为什么必须锁定准确 MPN

LM358DR、LM358D 和不同包装后缀可能对应不同商品记录。监控只保存完整 MPN、制造商和请求市场，不能把模糊关键词返回的相似商品拼成一条库存。导入 BOM 时先去掉空格和明显格式错误，再人工确认封装、温度范围、包装和环保后缀。

在 Chip Monitor 芯片库存监控工作台 添加目标后，建议把原始 BOM 编号作为备注保存，但不要用内部 SKU 替代供应商 MPN。这样库存变化、价格档位和采购链接才能稳定关联。

DigiKey API 通常能返回什么

API 只返回它在当前应用权限、区域和请求参数下能看到的数据。字段缺失时，不要使用上一次价格冒充当前价格，也不要把没有价格当成零库存。

一次监控检查如何完成

1. 规范化完整 MPN，并确认当前市场和货币设置。
2. 使用已批准的 OAuth 应用获取访问令牌；令牌应放在服务端，不写入日志或浏览器。
3. 请求 Product Details，校验返回的制造商和 MPN 与目标一致。
4. 记录库存、价格、交期、来源、响应时间和上游状态码。
5. 只有结果可解析且身份匹配时，才更新库存状态和提醒基线。

这种顺序能避免把一次授权失败、429 限流或代理超时写成 0。平台会把失败保留为诊断事件，让下一次有效响应继续参与比较。

如何读状态和异常

• 有库存：本次响应给出可验证的正库存数量，仍应查看时间和市场。
• 暂时缺货：DigiKey 明确返回零库存或不可售；应与交期信息一起看。
• 未知/采集失败：没有足够证据，常见原因是 401/403、令牌过期、429、超时或字段变化。
• 已过期：最近成功数据超过渠道允许的时间窗，不能继续当作实时库存。

如果同一个型号连续出现 401，先检查应用批准范围和令牌；连续 429 则降低频率并遵循官方限额；单个型号超时不应让整批目标都变成缺货。

配额和监控频率怎么安排

DigiKey 官方文档区分标准 Product Information 预算和经过人工批准的更高预算。常见标准值为每分钟 120 次、每天 1,000 次；单独批准的产品可达到每天 10,000 次，实际仍以账号响应头和合同为准。不要把每个型号都按最大额度持续打满，应按目标数量、变化速度和失败重试预算计算间隔。

在 DigiKey 集成说明 中先确认传输方式和凭证状态，再在监控规则中设置频率。短时间内把重试翻倍，通常只会更快触发限流；指数退避和按渠道暂停更安全。

API 失败时怎么办

DigiKey 当前的公开网页路径和官方 API 是不同传输方式。API 返回错误时，平台不会偷偷切换到网页抓取，因为两者的登录、字段和证据边界不同。若管理员明确启用了公开网页路径，才会把它作为另一条独立的监控配置。

排查顺序是：确认 MPN 身份、查看最近成功时间、检查令牌和批准范围、对照市场与货币、最后检查网络和限流。修复后先用一个型号验收，再恢复批量规则。

常见问题

OAuth 成功后为什么仍然查不到型号？

OAuth 只说明应用完成认证，不保证目录权限、市场和产品范围都正确。需要检查请求参数和返回商品身份；权限不足应显示为错误，而不是缺货。

价格变化就是库存变化吗？

不是。价格档位、货币或采购数量变化可能独立发生。通知规则应分别设置库存和价格条件，避免一次报价刷新产生库存告警。

可以用一次 API 请求监控很多型号吗？

是否支持批量取决于具体接口和账号额度。平台按明确的目标记录保存结果，即使上游支持批量，也会逐个校验 MPN，避免一条错误响应覆盖整批目标。

证据边界

本文依据 DigiKey 公开开发者文档和 Chip Monitor 当前接入契约整理。API 字段、配额、授权和商业库存可能变化；lastReviewedAt 只是本文复核日期，不是供货保证。做采购决定前，请打开官方商品信息并再次确认价格、库存、交期和订单条件。

可先从一个精确型号开始，在 DigiKey 集成页 查看接入边界，再回到 库存监控首页 扩展到 BOM。