API接口文档

完善的RESTful API接口，支持与任意第三方系统对接

接口概述

我们的API采用RESTful架构设计，返回数据格式为JSON。所有接口均需要认证，支持API Key和OAuth 2.0两种认证方式。

API接口覆盖代购业务全流程，包括商品管理、订单处理、仓储物流、财务结算等模块。

商品监控接口

用于获取雅虎、煤炉平台的商品信息，支持关键词搜索和条件筛选。

GET /api/v1/products/search 
{
  "keyword": "游戏机",
  "platform": "yahoo",
  "min_price": 1000,
  "max_price": 50000,
  "page": 1,
  "limit": 20
}

竞拍出价接口

提交代拍请求，系统自动进行竞拍，支持设置最高出价和自动跟单。

POST /api/v1/auction/bid 
{
  "product_id": "yahoo123456",
  "max_bid": 15000,
  "auto_extend": true,
  "snipe_time": 30
}

订单管理接口

创建、查询、修改订单，支持批量操作和订单合并。

GET /api/v1/orders?status=pending&page=1 
{
  "orders": [
    {
      "order_id": "ORD2024123001",
      "product": "Switch游戏机",
      "price": 12800,
      "status": "paid",
      "warehouse": "东京仓"
    }
  ],
  "total": 156,
  "page": 1
}

仓储物流接口

查询库存状态、申请打包发货、获取物流单号。

POST /api/v1/warehouse/ship 
{
  "order_ids": ["ORD2024123001", "ORD2024123002"],
  "shipping_method": "航空 SAL",
  "destination": "中国-北京"
}

财务结算接口

获取账单明细、申请提现、查看汇率记录。

GET /api/v1/finance/balance 
{
  "available": 125800.50,
  "frozen": 35000.00,
  "currency": "CNY",
  "rates": {
    "JPY": 0.0485,
    "USD": 7.12
  }
}

SDK与集成

我们提供多种编程语言的SDK，简化API集成：