开发者资料
开发者与数据接入
提供只读公开 API、Atom 订阅、LDXP Connector 和商家 JSON Feed。接口不承诺商业 SLA，请使用缓存并控制请求频率。
公开 API
接口与公开目录使用同一批已发布数据。客户端需要处理超时、空结果和字段调整。
GET /api/v1/products标准产品卡片、近期有货观测价、官方价格参考与信息覆盖情况。
GET /api/v1/catalog/groups跨产品同款报价目录，支持交付、期限、质保、库存、更新时间和价格区间筛选。
GET /api/v1/products/{slug}产品详情与同款报价；90 天历史趋势由独立 history 接口按需加载。
GET /api/v1/products/{slug}/history按需读取最近 90 天聚合价格与库存趋势，支持 source_platform 筛选。
GET /api/v1/corrections已解决且允许公开的纠错摘要，不返回联系方式和原始私密内容。
GET /api/v1/watch.atom?targets={slug}:{price}无需账号的价格与补货 Atom Feed；targets 必填，可用逗号分隔多个 product-slug[:目标价]。
Atom 示例：/api/v1/watch.atom?targets=chatgpt-plus:16,claude-pro（客户端构造时请对 targets 查询参数进行 URL 编码）。未提供有效 targets 时接口会返回 422。
AI Agent 开放数据协议与静态 Feed
面向大模型、自主 Agent 与自动化脚本的只读快照流，零数据库查询消耗，支持高并发与缓存加速。
GET /.well-known/price-radar.jsonRFC 规范的机器自发现元数据指针，包含当前最新快照地址、契约文档与 Schema 规范。
GET /price-radar-api.md专为 AI Agent 和 LLM 提示词设计的 Markdown 接入说明，包含快照结构与缓存策略。
GET /data/latest.json最新目录快照指针（约 1KB），轮询间隔建议 60 秒以上，返回不可变快照文件的 URL 与时间戳。
GET /data/v1/snapshots/{id}.json不可变全量/Top 5 标准报价快照，完全静态化服务，客户端与 CDN 可永久缓存。
商家 JSON Feed
Feed 可返回商品数组，或包含 shop、updated_at、items 的对象。商品至少提供稳定 ID、名称和来源 URL；价格、库存、类别与公开描述按统一导入模型处理。
提交 Feed 地址