BOMYG 外部接口调用教程

本文档介绍如何使用 BOMYG 对外接口 获取商品的基本信息与库存价格数据。
接口采用 POST 请求方式，返回标准 JSON 数据。

注意： 所有接口调用前需先获取合法的账号与 API Key，具体请联系平台客服申请。

一、接口 1：获取商品 ID 与 SPU

接口说明

此接口用于批量获取商城中所有含有样品库存或整盘库存的商品编号。
每个商品包含唯一的 goods_id 和对应的 spu。

后续进行库存、价格矫正或比对操作时，请务必以 goods_id 为唯一标识。

请求地址

https://www.bomyg.com/duiwaiapi/get-goods_id.php

请求方式

POST

请求参数

请求示例

curl -X POST https://www.bomyg.com/duiwaiapi/get-goods_id.php \
  -d "account=【请向客服索取】" \
  -d "api_key=【请向客服索取】"

返回示例

[
  {
    "goods_id": "903424",
    "spu": "GR1210F0R039T5G00"
  },
  {
    "goods_id": "903425",
    "spu": "GR0603F100K1T5G00"
  }]

返回说明

二、接口 2：获取商品详细信息（库存、价格、规格等）

 接口说明

通过 goods_id 查询单个商品的详细信息，包括：

• 商品名称、封装规格、品牌；

• 样品/整盘库存；

• 价格；

• 数据手册链接等。

请求地址

https://www.bomyg.com/duiwaiapi/get_store_count.php

请求方式

POST

请求参数

请求示例

curl -X POST https://www.bomyg.com/duiwaiapi/get_store_count.php \
  -d "account=【请向客服索取】" \
  -d "api_key=【请向客服索取】" \
  -d "goods_id=903424"

返回示例

{
  "status": "success",
  "goods_id": "903424",
  "spu": "GR1210F0R039T5G00",
  "goods_name": "1210 0Ω039 ±1% 1/2W",
  "goods_spec": "1210",
  "brand_name": "鼎声微",
  "mpq": 5000,
  "moq": 5000,
  "piq": 5000,
  "packed_stock": 1015000,
  "kingdee_shop_price": "0.03900",
  "cat_id": 11142,
  "cat_name": "厚膜电阻",
  "data_book": "https://www.bomyg.com/images/guigeshu2/dingshengwei/GR.pdf",
  "attributes": {
    "功率": "1/2W",
    "精度": "±1%",
    "阻值": "0.039Ω"
  }}

返回字段说明

 使用建议

1. 调用顺序

• 先调用接口① 获取 goods_id 与 spu；

• 再逐个调用接口② 获取详细信息。

2. 唯一标识

• 请使用 goods_id 作为商品唯一标识进行库存或价格更新。

3. 调用频率

• 若需批量同步，请合理设置请求间隔，避免过高频率访问导致封禁。

4. 安全提示

• 所有账号与 API Key 均属于保密信息，请勿硬编码或公开。

• 使用前请向官方客服索取正式授权。

一、API 调用示例

curl -X POST https://www.bomyg.com/duiwai/get-order.php \

-H "Content-Type: application/x-www-form-urlencoded" \

-d 'order_sn=85220251120120001' \  (自定义）

-d 'user_id=' \         （注册成为会员后，请想客服索取相对应的ID）

-d 'consignee=张三' \

-d 'mobile=15917352329' \

-d 'province=浙江省' \

-d 'city=杭州市' \

-d 'district=西湖区' \

-d 'twon=文三街道' \

-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"}]'

二、接口用途说明

该接口用于 向系统提交订单，包含收货信息、用户信息、商品明细等内容。后台会根据提交的数据生成订单记录，并返回相应结果。

三、请求方式

请求方法： POST

Content-Type： application/x-www-form-urlencoded

接口地址： https://www.bomyg.com/jiepeiapi/get-order.php

四、参数说明

下面列出每个参数的行为与意义：

1. 订单基础信息

参数名 含义 示例

order_sn 订单编号 85220251120120001

user_id 用户 ID   （注册成为会员后，请向客服索取）

2. 收货人信息

参数名 含义 示例

consignee 收货人姓名 张三

mobile 联系电话 15917352329

province 省份 浙江省

city 城市 杭州市

district 区县 西湖区

twon 街道/乡镇 文三街道

address 详细地址 文三路123号

3. 商品列表参数（goods_list）

该参数为一个 JSON 数组字符串，每个元素表示一个商品项：

[

  {

    "goods_id": 572174,

    "goods_num": 20,

    "goods_price": "0.00179"

  },

  {

    "goods_id": 1443,

    "goods_num": 3000,

    "goods_price": "0.00142"

  }

]

字段名 含义 示例

goods_id 商品 ID 572174

goods_num 数量 20

goods_price 单价（元） 0.00179

注意： 该字段在 curl 中必须以字符串形式提交，如：

-d 'goods_list=[{"goods_id":572174,...}]'

五、返回结果示例（假设）

接口返回通常为 JSON 格式，例如：

{

  "status": 1,

  "msg": "订单提交成功",

  "order_id": 123456

}

字段名 含义

status 状态码，1 表示成功

msg 返回消息

order_id 下单后生成的订单ID