海外账号吧
登录
置顶

API接口文档

API认证方式

所有API请求需要在请求头中携带API密钥：

  • X-API-Key: your_api_key
  • 或 Authorization: Bearer your_api_key

您可以在用户中心查看和管理您的API密钥

基础信息

Base URL: https://www.hwzh8.cc/api

响应格式: JSON

编码: UTF-8

商品接口
GET /goods

获取商品列表，支持分页和筛选

请求参数
参数名 类型 位置 必填 说明
group_id integer query 可选 商品分组ID
type integer query 可选 商品类型
search string query 可选 搜索关键词
per_page integer query 可选 每页数量，最多100
默认值: 15
page integer query 可选 页码
默认值: 1
响应示例
{ "success": true, "message": "操作成功", "data": { "current_page": 1, "data": [ { "id": 1, "name": "商品名称", "description": "商品描述", "picture": "https:\/\/example.com\/picture.jpg", "price": 99, "sales_volume": "api.example_data.total_100", "type": 1, "type_name": "规格名称", "subs": [ { "id": 1, "name": "规格名称", "price": 99, "stock": "api.example_data.total_100" } ] } ], "total": "api.example_data.total_100", "per_page": 15 }
}
代码示例
curl -X GET "https://www.hwzh8.cc/api/goods" \ -H "X-API-Key: your_api_key" \ -H "Content-Type: application/json"
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.hwzh8.cc/api/goods");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-API-Key: your_api_key", "Content-Type: application/json"
]);
$response = curl_exec($ch);
curl_close($ch);
import requests headers = { "X-API-Key": "your_api_key", "Content-Type": "application/json"
} response = requests.get( "https://www.hwzh8.cc/api/goods", headers=headers
)
fetch("https://www.hwzh8.cc/api/goods", { method: "GET", headers: { "X-API-Key": "your_api_key", "Content-Type": "application/json" }
})
.then(response => response.json())
.then(data => );
GET /goods/{id}

根据商品ID获取商品详细信息

请求参数
参数名 类型 位置 必填 说明
id integer path 必填 商品ID
响应示例
{ "success": true, "message": "操作成功", "data": { "id": 1, "name": "商品名称", "description": "商品描述", "detail": "商品详情内容", "usage_instructions": "使用说明", "picture": "https:\/\/example.com\/picture.jpg", "price": 99, "sales_volume": "api.example_data.total_100", "type": 1, "type_name": "规格名称", "require_login": false, "subs": [] }
}
代码示例
curl -X GET "https://www.hwzh8.cc/api/goods/{id}" \ -H "X-API-Key: your_api_key" \ -H "Content-Type: application/json"
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.hwzh8.cc/api/goods/{id}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-API-Key: your_api_key", "Content-Type: application/json"
]);
$response = curl_exec($ch);
curl_close($ch);
import requests headers = { "X-API-Key": "your_api_key", "Content-Type": "application/json"
} response = requests.get( "https://www.hwzh8.cc/api/goods/{id}", headers=headers
)
fetch("https://www.hwzh8.cc/api/goods/{id}", { method: "GET", headers: { "X-API-Key": "your_api_key", "Content-Type": "application/json" }
})
.then(response => response.json())
.then(data => );
GET /goods/{id}/stock

获取商品各规格的库存信息

请求参数
参数名 类型 位置 必填 说明
id integer path 必填 商品ID
响应示例
{ "success": true, "message": "操作成功", "data": { "goods_id": 1, "goods_name": "商品名称", "subs": [ { "sub_id": 1, "sub_name": "规格名称", "stock": "api.example_data.total_100", "price": 99 } ] }
}
代码示例
curl -X GET "https://www.hwzh8.cc/api/goods/{id}/stock" \ -H "X-API-Key: your_api_key" \ -H "Content-Type: application/json"
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.hwzh8.cc/api/goods/{id}/stock");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-API-Key: your_api_key", "Content-Type: application/json"
]);
$response = curl_exec($ch);
curl_close($ch);
import requests headers = { "X-API-Key": "your_api_key", "Content-Type": "application/json"
} response = requests.get( "https://www.hwzh8.cc/api/goods/{id}/stock", headers=headers
)
fetch("https://www.hwzh8.cc/api/goods/{id}/stock", { method: "GET", headers: { "X-API-Key": "your_api_key", "Content-Type": "application/json" }
})
.then(response => response.json())
.then(data => );
用户接口
GET /balance

获取当前用户的余额信息

响应示例
{ "success": true, "message": "操作成功", "data": { "balance": 1000, "total_spent": 5000, "level_name": "白银会员" }
}
代码示例
curl -X GET "https://www.hwzh8.cc/api/balance" \ -H "X-API-Key: your_api_key" \ -H "Content-Type: application/json"
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.hwzh8.cc/api/balance");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-API-Key: your_api_key", "Content-Type: application/json"
]);
$response = curl_exec($ch);
curl_close($ch);
import requests headers = { "X-API-Key": "your_api_key", "Content-Type": "application/json"
} response = requests.get( "https://www.hwzh8.cc/api/balance", headers=headers
)
fetch("https://www.hwzh8.cc/api/balance", { method: "GET", headers: { "X-API-Key": "your_api_key", "Content-Type": "application/json" }
})
.then(response => response.json())
.then(data => );
订单接口
POST /purchase

创建订单并购买商品

请求参数
参数名 类型 位置 必填 说明
goods_id integer query 必填 商品ID
sub_id integer query 必填 商品规格ID
quantity integer query 必填 购买数量
最小值: 1
email string query 可选 联系邮箱
payway string query 必填 支付方式ID或"balance"（余额支付）
search_pwd string query 可选 查询密码
响应示例
{ "success": true, "message": "订单创建成功", "data": { "order_sn": "订单号", "status": 4, "total_price": 99, "actual_price": 94.05, "balance_used": 0 }
}
代码示例
curl -X POST "https://www.hwzh8.cc/api/purchase" \ -H "X-API-Key: your_api_key" \ -H "Content-Type: application/json"
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.hwzh8.cc/api/purchase");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-API-Key: your_api_key", "Content-Type: application/json"
]);
$response = curl_exec($ch);
curl_close($ch);
import requests headers = { "X-API-Key": "your_api_key", "Content-Type": "application/json"
} response = requests.post( "https://www.hwzh8.cc/api/purchase", headers=headers
)
fetch("https://www.hwzh8.cc/api/purchase", { method: "POST", headers: { "X-API-Key": "your_api_key", "Content-Type": "application/json" }
})
.then(response => response.json())
.then(data => );