电子元器件数据查询 API · 为 AI 代理和第三方系统设计
查询公开库存列表，支持关键词搜索和分页。
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
| q | string | 搜索关键词（匹配物料名称、规格、备注） | ?q=电阻 |
| page | number | 页码，默认 1 | ?page=1 |
| limit | number | 每页条数，默认 20，最大 100 | ?limit=50 |
| 字段 | 类型 | 说明 |
|---|---|---|
| success | boolean | 是否成功 |
| data[] | array | 库存条目列表 |
| data[].id | string | 库存ID |
| data[].name | string | 物料名称 |
| data[].specification | string | 规格型号 |
| data[].quantity | string | 数量 |
| data[].unit | string | 单位 |
| data[].price | string | 参考价格 |
| data[].remark | string | 备注说明 |
| data[].created_at | string | 发布时间 |
| data[].message_count | number | 咨询消息数 |
| data[].detail_url | string | 详情页路径 |
| pagination | object | 分页信息（page/limit/total/total_pages） |
| query | string|null | 当前搜索词 |
查询公开优势物料列表（仅返回全市场可见的条目），支持关键词搜索和分页。
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
| q | string | 搜索关键词（匹配分类、规格、封装、供应商等） | ?q=电容 |
| page | number | 页码，默认 1 | ?page=1 |
| limit | number | 每页条数，默认 20，最大 100 | ?limit=50 |
| 字段 | 类型 | 说明 |
|---|---|---|
| success | boolean | 是否成功 |
| data[] | array | 优势物料条目列表 |
| data[].id | string | 物料ID |
| data[].category | string | 元器件分类 |
| data[].specification | string | 规格参数 |
| data[].package_type | string | 封装 |
| data[].package_quantity | string | 包装数量 |
| data[].package_form | string | 包装形式 |
| data[].price | string | 价格 |
| data[].delivery_time | string | 交期 |
| data[].success_domains | string | 成功应用领域 |
| data[].success_customers | string | 成功使用客户 |
| data[].mass_production_years | string | 批量上市年限 |
| data[].supplier_company | string | 供应商名称 |
| data[].contact_person | string | 联系人 |
| data[].created_at | string | 发布时间 |
| data[].detail_url | string | 详情页路径 |
| pagination | object | 分页信息（page/limit/total/total_pages） |
| query | string|null | 当前搜索词 |
{
"success": true,
"data": [
{
"id": "abc123...",
"category": "电阻",
"specification": "0402 10kΩ ±1%",
"package_type": "SMD-0402",
"package_quantity": "10000pcs/盘",
"package_form": "编带 (Tape & Reel)",
"price": "¥0.008/pcs",
"delivery_time": "现货 (In Stock)",
"success_domains": "消费电子,汽车电子",
"success_customers": "华为,大疆",
"mass_production_years": "2020年",
"supplier_company": "XX电子有限公司",
"contact_person": "张三",
"created_at": "2026-05-20T10:00:00",
"detail_url": "/srm/advantage-materials?q=电阻"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 42,
"total_pages": 3
},
"query": null
}查询单条优势物料详情，返回完整字段信息。
与列表接口的 data[] 字段一致，包含单个物料的全部公开信息。
{
"success": true,
"data": {
"id": "abc123...",
"category": "电容",
"specification": "10μF 25V X7R",
"package_type": "SMD-0805",
"package_quantity": "3000pcs/盘",
"package_form": "编带 (Tape & Reel)",
"price": "¥0.05/pcs",
"delivery_time": "现货 (In Stock)",
"success_domains": "消费电子,工业控制",
"success_customers": "华为",
"mass_production_years": "2021年",
"supplier_company": "YY科技有限公司",
"contact_person": "李四",
"created_at": "2026-05-20T10:00:00",
"detail_url": "/srm/advantage-materials?q=电容"
}
}| 🔓 | 无需认证 — 所有 API 均公开可访问，无需 Token 或 API Key |
| 📄 | 返回格式 — 统一 JSON，Content-Type: application/json |
| 🌐 | 跨域 — 支持 CORS，可直接在浏览器中调用 |
| 📊 | 分页 — 所有列表接口均支持 page / limit 参数 |
| 🇨🇳 | 中文友好 — 字段值为中文，方便 AI 直接理解 |
| 🤖 | AI 代理 / ChatGPT Plugin — 自动查询元器件库存和优势物料 |
| 📱 | 第三方系统 — 对接 ERP / 采购系统数据同步 |
| 🔗 | 数据采集 — 搜索引擎爬虫 / 行业聚合平台抓取 |
| 📊 | 数据分析 — 物料价格趋势、供应商能力分析 |
| 🏆 | 选型推荐 — 基于优势物料库的智能元器件选型 |