快速开始

BuyEasy OpenAPI 快速开始

一套 App Key / Secret 同时调用商品 API、订单采购 API 和 AI 模型。先验证商品能力，再根据业务需要完成平台授权和订单联调。

进入客户后台 查看淘宝新规则

四步完成接入

01

创建应用密钥

登录客户后台，在开放平台中创建 App Key / Secret。Secret 只展示一次，请妥善保存。

02

先调商品接口

商品搜索和详情可先验证鉴权、计费和返回结构；淘宝详情请传 item_url 或 tao_password。

03

订单前完成授权

订单预览、下单和支付必须由客户授权自己的购物平台账号，资金从客户账号侧扣除。

04

接入 AI 模型

AI 模型使用同一套 App Key / Secret，并兼容 OpenAI SDK Base URL 调用方式。

统一鉴权

所有开放接口都使用同一套请求头。建议订单和 AI 请求带上 Idempotency-Key，避免网络重试造成重复扣费或重复操作。

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" \
  -H "Idempotency-Key: unique-business-request-id" \
  -d '{
    "item_url": "https://item.taobao.com/item.htm?id=123456",
    "country_code": "en"
  }'