开放平台API接口 - 电子元器件数据服务

核心能力

三大核心数据接口

覆盖商品查询、库存价格、订单提交全链路，简单易用，快速集成

商品 ID 与 SPU 查询

批量获取商城所有含样品库存或整盘库存的商品编号，每个商品包含唯一的 goods_id 和 spu 编码，作为后续数据操作的基础标识

批量查询 SPU 编码数据同步

库存与价格详情查询

通过 goods_id 查询单个商品的全部详细信息，包括商品名称、封装规格、品牌、样品/整盘库存、最新价格、数据手册链接等

实时库存价格查询规格参数

订单提交接口

通过 API 提交完整订单信息，包含收货地址、商品明细、价格等，系统自动生成订单记录并返回订单 ID，实现采购系统无缝对接

下单接口收货信息商品明细

应用场景

多种场景，灵活对接

无论您是自建商城、ERP 系统还是采购平台，都能轻松集成

电子商城对接

自建元器件电商网站可通过 API 实时同步商品数据、库存和价格，确保前后端数据一致，提升用户购物体验

商品同步库存实时价格更新

ERP / 进销存系统

将 BOMYG 商品数据与物料编码集成到企业 ERP 系统，采购员在 ERP 内即可查询库存、比价并直接下单，减少人工录入

ERP 集成自动下单数据同步

采购管理平台

企业内部采购系统通过 API 自动获取 BOM 匹配结果与供应商报价，实现比价、下单、跟单全流程自动化

BOM 匹配自动比价流程自动化

移动端 / 小程序

移动应用或微信小程序接入 API 后，用户可随时随地查询元器件库存、价格和下单，拓展采购场景

小程序移动端随时随地

数据分析与报表

通过 API 获取价格走势与库存数据，构建企业采购数据分析系统，辅助采购决策与供应链优化

价格分析数据报表决策支持

第三方服务平台

供应链金融、物流平台、SaaS 服务商可通过 API 集成元器件数据，为上下游客户提供增值服务

SaaS 集成供应链增值服务

接口详情

丰富的接口能力

标准 POST 请求，JSON 数据格式，统一错误处理

获取商品 ID 与 SPU

批量获取所有含样品库存或整盘库存的商品编号，以 goods_id 为唯一标识，SPU 为标准物料编号

POST /duiwaiapi/get-goods_id.php

获取商品详细信息

通过 goods_id 查询商品名称、封装规格、品牌、样品/整盘库存、最新价格、数据手册链接、扩展属性等全维度数据

POST /duiwaiapi/get_store_count.php

订单提交接口

提交完整订单信息：收货人、联系电话、省市地址、商品列表（goods_id + 数量 + 单价），后台自动生成订单记录并返回订单 ID

POST /jiepeiapi/get-order.php

安全与鉴权

所有接口采用 account + api_key 双重鉴权，API Key 需向客服申请。支持请求频率控制，确保服务稳定可靠

POST X-API-Key Auth

接口名称	请求地址	方法	主要参数	状态
商品 ID 与 SPU 查询	/duiwaiapi/get-goods_id.php	POST	account, api_key	已上线
商品详情（库存/价格）	/duiwaiapi/get_store_count.php	POST	account, api_key, goods_id	已上线
订单提交	/jiepeiapi/get-order.php	POST	order_sn, user_id, consignee, mobile, address, goods_list	已上线

调用示例

接口调用与返回示例

点击标签切换接口，查看详细请求参数与返回数据

接口1：商品 ID 查询接口2：库存价格详情接口3：订单提交

POST /duiwaiapi/get-goods_id.php

// 请求示例（curl）
curl -X POST https://api.bomyg.com/duiwaiapi/get-goods_id.php \
  -d "account=【请联系客服获取】" \
  -d "api_key=【请联系客服获取】"

// 返回示例（JSON）
[
  {
    "goods_id": "903424",
    "spu": "GR1210F0R039T5G00"
  },
  {
    "goods_id": "903425",
    "spu": "GR0603F100K1T5G00"
  }
]

                     请求参数
                    
                        参数名类型必填说明
accountstring是API 账号（向客服索取）
api_keystring是API 密钥（向客服索取）

                

                     返回字段
                    
                        字段名类型说明
goods_idstring商品唯一编号
spustring标准物料编号（可重复）

                

参数名	类型	必填	说明
account	string	是	API 账号（向客服索取）
api_key	string	是	API 密钥（向客服索取）

字段名	类型	说明
goods_id	string	商品唯一编号
spu	string	标准物料编号（可重复）

POST /duiwaiapi/get_store_count.php

// 请求示例（curl）
curl -X POST https://api.bomyg.com/duiwaiapi/get_store_count.php \
  -d "account=【请联系客服获取】" \
  -d "api_key=【请联系客服获取】" \
  -d "goods_id=903424"

// 返回示例（JSON）
{
  "status": "success",
  "goods_id": "903424",
  "spu": "GR1210F0R039T5G00",
  "goods_name": "1210 0Ω039 ±1% 1/2W",
  "goods_spec": "1210",
  "brand_name": "鼎声微",
  "mpq": 5000,
  "moq": 5000,
  "packed_stock": 1015000,
  "kingdee_shop_price": "0.03900",
  "cat_name": "厚膜电阻",
  "data_book": "https://...",
  "attributes": {
    "功率": "1/2W",
    "精度": "±1%",
    "阻值": "0.039Ω"
  }
}

                     请求参数
                    
                        参数名类型必填说明
accountstring是API 账号
api_keystring是API 密钥
goods_idint是商品 ID（来自接口1返回结果）

                

                     返回字段
                    
                        字段名说明
status接口状态（success / fail）
goods_id商品唯一 ID
spu标准物料编码
goods_name商品名称（含主要参数）
goods_spec封装规格
brand_name品牌名称
packed_stock当前库存数量
kingdee_shop_price最新商城价格
data_book数据手册链接
attributes扩展参数（功率/精度/阻值等）

                

参数名	类型	必填	说明
account	string	是	API 账号
api_key	string	是	API 密钥
goods_id	int	是	商品 ID（来自接口1返回结果）

字段名	说明
status	接口状态（success / fail）
goods_id	商品唯一 ID
spu	标准物料编码
goods_name	商品名称（含主要参数）
goods_spec	封装规格
brand_name	品牌名称
packed_stock	当前库存数量
kingdee_shop_price	最新商城价格
data_book	数据手册链接
attributes	扩展参数（功率/精度/阻值等）

POST /jiepeiapi/get-order.php

// 请求示例（curl）
curl -X POST https://api.bomyg.com/jiepeiapi/get-order.php \
  -d "order_sn=85220251120120001" \
  -d "user_id=10001" \
  -d "consignee=张三" \
  -d "mobile=15917352329" \
  -d "province=浙江省" \
  -d "city=杭州市" \
  -d "district=西湖区" \
  -d "address=文三路123号" \
  -d 'goods_list=[{"goods_id":572174,"goods_num":20,"goods_price":"0.00179"},{"goods_id":1443,"goods_num":3000,"goods_price":"0.00142"}]'

// 返回示例（JSON）
{
  "status": 1,
  "msg": "订单提交成功",
  "order_id": 123456
}

                     请求参数
                    
                        参数名类型必填说明
order_snstring是订单编号
user_idstring是用户 ID（向客服索取）
consigneestring是收货人姓名
mobilestring是联系电话
provincestring是省份
citystring是城市
districtstring否区县
addressstring是详细地址
goods_liststring(JSON)是[{"goods_id":572174,"goods_num":20,"goods_price":"0.00179"}]

                

                     返回字段
                    
                        字段名说明
status状态码，1 为成功
msg返回消息
order_id生成的订单 ID

                

参数名	类型	必填	说明
order_sn	string	是	订单编号
user_id	string	是	用户 ID（向客服索取）
consignee	string	是	收货人姓名
mobile	string	是	联系电话
province	string	是	省份
city	string	是	城市
district	string	否	区县
address	string	是	详细地址
goods_list	string(JSON)	是	[{"goods_id":572174,"goods_num":20,"goods_price":"0.00179"}]

字段名	说明
status	状态码，1 为成功
msg	返回消息
order_id	生成的订单 ID

使用建议

最佳实践与注意事项

快速掌握接口使用技巧，避免常见问题

频率控制建议

批量同步时请合理设置请求间隔，避免过高频率访问。建议每次请求间隔 ≥200ms，单日大量调用请提前联系客服申请额度。

安全注意事项

所有 account 与 api_key 均属保密信息，请勿硬编码或公开。建议保存在服务端环境变量中，使用 HTTPS 传输，定期更换密钥。

常见问题

开发者 FAQ

如何获取 API 账号与密钥？

所有接口调用前需先获取合法的 account 与 api_key，具体请联系平台客服申请。请勿将密钥硬编码或公开。

接口调用顺序是什么？

建议先调用接口1（获取商品 ID 与 SPU）获得全部商品的 goods_id，再逐个调用接口2（获取详细信息）查询库存与价格。订单提交接口可直接使用已知的 goods_id 下单。

接口有哪些安全限制？

接口采用 account + api_key 双重鉴权，所有敏感信息请勿明文传输。若需批量同步，请合理设置请求间隔，避免过高频率访问导致封禁。

商品唯一标识用什么字段？

进行库存、价格矫正或比对操作时，请务必以 goods_id 作为商品的唯一标识。SPU 为标准物料编号，可能存在重复。

订单提交接口需要哪些参数？

订单提交需要以下参数：

参数名	说明
order_sn	订单编号
user_id	用户ID（向客服索取）
consignee	收货人姓名
mobile	联系电话
province/city/district	省市区域
address	详细地址
goods_list	JSON 数组：[{"goods_id":572174,"goods_num":20,"goods_price":"0.00179"}]

标品配齐，建立BOM配单

企业级数据
开放接口平台

三大核心数据接口

多种场景，灵活对接

丰富的接口能力

获取商品 ID 与 SPU

获取商品详细信息

订单提交接口

安全与鉴权

三步完成接口对接

申请 API 授权

查阅接口文档

集成与测试

API 接口一览

接口调用与返回示例

请求参数

返回字段

请求参数

返回字段

请求参数

返回字段

最佳实践与注意事项

推荐调用顺序

频率控制建议

安全注意事项

立即申请 API 接入

开发者 FAQ

联系我们

标品配齐，建立BOM配单

企业级数据开放接口平台

三大核心数据接口

多种场景，灵活对接

丰富的接口能力

获取商品 ID 与 SPU

获取商品详细信息

订单提交接口

安全与鉴权

三步完成接口对接

申请 API 授权

查阅接口文档

集成与测试

API 接口一览

接口调用与返回示例

请求参数

返回字段

请求参数

返回字段

请求参数

返回字段

最佳实践与注意事项

推荐调用顺序

频率控制建议

安全注意事项

立即申请 API 接入

开发者 FAQ

联系我们

企业级数据
开放接口平台