BuyEasy OpenAPI 文档

淘宝商品与采购 API

按 BuyEasy 统一协议接入淘宝商品、图片检索、店铺商品和采购链路

客户只需要接 BuyEasy OpenAPI，鉴权、计费、日志和平台授权由 BuyEasy 统一处理。商品查询可使用平台备用能力兜底；订单预览、下单和支付必须使用客户自己的淘宝授权账号。

统一鉴权

x-api-key + Authorization Bearer

可计费

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

订单隔离

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

JSON 返回

统一 success / code / data 结构

请求入口

Base URL: https://你的域名

Header: x-api-key / Authorization

接入说明

商品查询和详情可先调用，未授权时可按平台策略走备用能力
订单预览、下单、支付前，客户必须在客户后台完成淘宝账号授权
订单支付接口默认受保护，生产联调证据完整后才能放行

淘宝商品详情已按最新规则更新：不再支持 goods_id、item_id 或 mi_id 作为标准入参。请优先传 item_url，其次传 tao_password。

POST/api/open/taobao/items/search

商品搜索

根据关键词检索淘宝商品，返回统一商品列表结构。

可走平台备用能力

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

参数	类型	必填	说明	示例
keywords	string	是	搜索关键词	wireless mouse
page	number	否	页码，默认 1	1
limit	number	否	每页数量，1-20，默认 20	20
country_code	string	否	多语言编码：en、ja、vi、ru、ko	en
price_start	number	否	最低价筛选	10
price_end	number	否	最高价筛选	80
order_desc	string	否	排序，如 price,asc 或 monthSold,desc	price,asc

keywordsstring是

搜索关键词

wireless mouse

pagenumber否

页码，默认 1

limitnumber否

每页数量，1-20，默认 20

country_codestring否

多语言编码：en、ja、vi、ru、ko

price_startnumber否

最低价筛选

price_endnumber否

最高价筛选

order_descstring否

排序，如 price,asc 或 monthSold,desc

price,asc

请求示例

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

返回示例

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

POST/api/open/taobao/items/detail

商品详情

通过商品链接或淘口令获取商品详情，返回规格、价格、库存、图片和多语言字段。

可走平台备用能力

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

参数	类型	必填	说明	示例
item_url	string	是	商品链接，推荐优先使用	https://item.taobao.com/item.htm?id=...
tao_password	string	否	淘口令；没有商品链接时可传；兼容 tkl、share_text	￥abc123￥
country_code	string	否	多语言编码：en、ja、vi、ru、ko	en
item_source_market	string	否	来源市场，可按业务需要传	taobao

item_urlstring是

商品链接，推荐优先使用

https://item.taobao.com/item.htm?id=...

tao_passwordstring否

淘口令；没有商品链接时可传；兼容 tkl、share_text

￥abc123￥

country_codestring否

多语言编码：en、ja、vi、ru、ko

item_source_marketstring否

来源市场，可按业务需要传

taobao

请求示例

curl -X POST "https://api.your-domain.com/api/open/taobao/items/detail" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_APP_KEY" \
-H "Authorization: Bearer YOUR_APP_SECRET" \
-d '{
  "item_url": "https://item.taobao.com/item.htm?id=123456",
  "country_code": "en"
}'

返回示例

{
  "success": true,
  "code": 0,
  "message": "success",
  "data": {
    "item": {
      "title": "Product title",
      "sku_list": [],
      "images": [],
      "price": "39.90"
    }
  },
  "billing": {
    "charged": 0.02,
    "product": "接口产品名称",
    "callId": 1024
  }
}

- 不要再传 goods_id、item_id 或 mi_id；系统会直接拒绝旧参数，避免客户按旧规则接入。