API 文档

本平台提供简洁的 RESTful API，可用于查询余额、获取商品列表、提交购买订单及查询订单状态。所有接口均需通过 API 密钥进行身份验证。

API 密钥可在 用户中心 生成和管理。

身份验证

所有 API 请求均需在请求头中携带 Authorization 字段，格式为：

Authorization: Bearer YOUR_API_KEY

请将 YOUR_API_KEY 替换为您在用户中心生成的 API 密钥。密钥格式为 sk- 开头。

查询余额

GET /api/get_money

查询当前 API 密钥对应账户的余额信息。

调用示例

curl -X GET "http://www.xiaohao.shop/api/get_money" -H "Authorization: Bearer YOUR_API_KEY"

响应示例

成功响应：

{
  "code": 0,
  "data": {
    "balance": 100.50
  }
}

错误响应：

{
  "code": 401,
  "msg": "API密钥无效"
}

分类列表

GET /api/categories

获取所有商品分类列表，包含每个分类下的可购买商品数量。

调用示例

curl -X GET "http://www.xiaohao.shop/api/categories" -H "Authorization: Bearer YOUR_API_KEY"

响应示例

成功响应：

{
  "code": 0,
  "data": [
    {
      "category_id": 1,
      "category": "Instagram",
      "count": 152
    }
  ]
}

错误响应：

{
  "code": 1,
  "msg": "加载分类失败，请稍后重试"
}

商品列表

GET /api/products

根据分类ID获取该分类下的可购买商品列表，支持分页。

请求参数

调用示例

curl -X GET "http://www.xiaohao.shop/api/products?category_id=1&page=1&page_size=50" -H "Authorization: Bearer YOUR_API_KEY"

响应示例

成功响应：

{
  "code": 0,
  "data": [
    {
      "title": "IG账户 | 不包含邮箱。…",
      "is_type": 1,
      "supplier": [{"partners_id":"2685","partners_price":0.146,"partners_qty":276}],
      "type": 1,
      "id": 21723,
      "price": 0.146,
      "stock": 50741
    }
  ],
  "total": 152,
  "page": 1,
  "page_size": 50,
  "total_pages": 4
}

错误响应：

{
  "code": 1,
  "msg": "缺少category_id参数"
}

商品购买

POST /api/buy

提交商品购买订单。支持供应商模式和刷单模式，请根据商品类型传入对应参数。

请求参数

调用示例

curl -X POST "http://www.xiaohao.shop/api/buy" -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_API_KEY" -d '{"product_id":21579,"quantity":100,"extra_info":"https://example.com"}'

响应示例

成功响应：

{
  "code": 0,
  "data": {
    "order_id": "ORD17835954843844815001"
  }
}

错误响应：

{
  "code": 1,
  "msg": "账户余额不足"
}

订单查询

GET /api/orders

查询订单信息。可通过 order_id 查询单个订单，或通过 page 分页查询订单列表（每页 10 条）。

请求参数

调用示例

curl -X GET "http://www.xiaohao.shop/api/orders?page=1" -H "Authorization: Bearer YOUR_API_KEY"

响应示例

成功响应：

{
  "code": 0,
  "list": [...],
  "total": 25,
  "page": 1,
  "page_size": 10,
  "total_pages": 3
}

错误响应：

{
  "code": 1,
  "msg": "订单不存在"
}

错误码说明

所有接口统一返回 JSON 格式，成功时 {"code": 0, "data": {...}}，失败时 {"code": 1, "msg": "错误描述"} 或 {"code": 401, "msg": "..."}。