BuyEasy OpenAPI 文档

微店商品与采购 API

统一接入微店商品查询、以图搜货和余额采购链路

微店侧采购通常使用客户微店账户余额完成。BuyEasy 负责统一鉴权、计费、日志和授权隔离。

统一鉴权

x-api-key + Authorization Bearer

可计费

成功调用写入账单和调用日志

订单隔离

采购支付只走客户授权账号

JSON 返回

统一 success / code / data 结构

请求入口

Base URL: https://你的域名

Header: x-api-key / Authorization

接入说明

商品查询可使用客户授权或平台备用能力
订单预览、下单和支付必须使用客户自己的微店授权账号
微店支付通常通过账户余额完成，客户需确保微店账户余额充足

统一流程为“订单预览 → 创建未付款订单 → 刷新确认 → 余额支付”；创建阶段不会扣款。微店独立付款方法完成官方文档核验和生产联调后再开放。

POST/api/open/weidian/items/search

商品搜索

按关键词搜索微店商品。

可走平台备用能力

未授权也可调用商品类接口；如客户授权且额度可用，优先使用客户授权

参数	类型	必填	说明	示例
keywords	string	是	搜索关键词	dress
page	number	否	页码	1
price_start	number	否	最低价	10
price_end	number	否	最高价	100

keywordsstring是

搜索关键词

dress

pagenumber否

页码

price_startnumber否

最低价

price_endnumber否

最高价

100

请求示例

curl -X POST "https://api.your-domain.com/api/open/weidian/items/search" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_APP_KEY" \
-H "Authorization: Bearer YOUR_APP_SECRET" \
-d '{ "keywords": "dress", "page": 1 }'

返回示例

{
  "success": true,
  "code": 0,
  "message": "success",
  "data": { "items": [], "source": "weidian" },
  "billing": {
    "charged": 0.02,
    "product": "接口产品名称",
    "callId": 1024
  }
}

POST/api/open/weidian/items/detail

商品详情

查询微店商品详情。

可走平台备用能力

未授权也可调用商品类接口；如客户授权且额度可用，优先使用客户授权

参数	类型	必填	说明	示例
goods_id	string	是	微店商品 ID，也可传 itemid	987654321
itemid	string	否	微店商品 ID，和 goods_id 二选一	987654321

goods_idstring是

微店商品 ID，也可传 itemid

987654321

itemidstring否

微店商品 ID，和 goods_id 二选一

987654321

请求示例

curl -X POST "https://api.your-domain.com/api/open/weidian/items/detail" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_APP_KEY" \
-H "Authorization: Bearer YOUR_APP_SECRET" \
-d '{ "goods_id": "987654321" }'

返回示例

{
  "success": true,
  "code": 0,
  "message": "success",
  "data": { "item": { "itemid": "987654321", "sku_list": [] } },
  "billing": {
    "charged": 0.02,
    "product": "接口产品名称",
    "callId": 1024
  }
}