BuyEasy OpenAPI 文档

淘宝商品、采购与售后 API

通过 BuyEasy OpenAPI 接入淘宝商品、采购订单、退款退货与售后协商

客户只需要接入 BuyEasy OpenAPI；鉴权、计费、日志、租户隔离与调用管理均由 BuyEasy 统一提供。订单和售后操作必须使用客户自己的淘宝授权账号。

统一鉴权

x-api-key + Authorization Bearer

可计费

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

订单隔离

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

JSON 返回

统一 success / code / data 结构

请求入口

Base URL: https://open.buyeasysaas.com

Header: x-api-key / Authorization

接入说明

商品搜索、详情、图搜和店铺商品可先完成接口联调
订单预览、下单、支付前，客户必须在客户后台完成淘宝账号授权
退款申请必须先渲染再提交；所有售后写操作必须携带唯一 Idempotency-Key
淘宝与1688支付统一由部署环境总开关控制，生产证据不作为前置门禁

淘宝短链 tk 会自动转换为 tao_password。查单新增标准化 purchase_order_lines；售后只读接口已可联调，写接口待真实小流量闭环后灰度启用。

POST/api/open/taobao/items/search

多语言商品搜索

按关键词检索商品，返回 BuyEasy 统一商品列表结构。

商品 API 已开通

商品搜索、详情、图搜和店铺商品按已开通产品直接调用。

参数	类型	必填	说明	示例
keywords	string	是	搜索关键词	wireless mouse
page	number	否	页码，默认 1	1
limit	number	否	每页数量，1-20，默认 20	20
country_code	string	否	多语言编码：en、ja、vi、ru、ko、th、km	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、th、km

price_startnumber否

最低价筛选

price_endnumber否

最高价筛选

order_descstring否

排序，如 price,asc 或 monthSold,desc

price,asc

请求示例

curl -X POST "https://open.buyeasysaas.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.027,
    "unitPrice": 0.027,
    "multiplier": 1,
    "product": "接口产品名称",
    "callId": 1024
  }
}

POST/api/open/taobao/items/detail

多语言商品详情与链接解析

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

商品 API 已开通

商品搜索、详情、图搜和店铺商品按已开通产品直接调用。

参数	类型	必填	说明	示例
item_url	string	否	标准商品长链接，或带 tk 的淘宝官方分享短链	https://e.tb.cn/h/example?tk=AbCdEf12345
tao_password	string	否	与 item_url 二选一；￥...￥形式，兼容 tkl	￥AbCdEf12345￥
link	string	否	兼容完整复制内容；自动识别长链接、短链或淘口令	【淘宝】https://e.tb.cn/h/example?tk=AbCdEf12345 商品标题
country_code	string	否	多语言编码：en、ja、vi、ru、ko、th、km	en
item_source_market	string	否	来源市场，可按业务需要传	taobao

item_urlstring否

标准商品长链接，或带 tk 的淘宝官方分享短链

https://e.tb.cn/h/example?tk=AbCdEf12345

tao_passwordstring否

与 item_url 二选一；￥...￥形式，兼容 tkl

￥AbCdEf12345￥

linkstring否

兼容完整复制内容；自动识别长链接、短链或淘口令

【淘宝】https://e.tb.cn/h/example?tk=AbCdEf12345 商品标题

country_codestring否

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

item_source_marketstring否

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

taobao

请求示例

curl -X POST "https://open.buyeasysaas.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.027,
    "unitPrice": 0.027,
    "multiplier": 1,
    "product": "接口产品名称",
    "callId": 1024
  }
}

- 标准商品页走 item_url；e.tb.cn/m.tb.cn/tb.cn 的 tk 自动转为 tao_password；无链接时可传￥...￥淘口令。商品 ID 只从上游响应取得，不再作为详情请求参数；短链转换不会丢失 language。