搜好货商品列表API接口允许开发者根据关键字搜索并获取相关的商品列表数据。接口支持多种参数配置,可以根据需求灵活调整搜索条件和结果返回格式。
API接口请求说明
- 请求地址:
https://api.souhaohuo.com/goods/search
- 请求方法:GET
- 请求参数:
keyword
(必填):搜索关键字,支持单个或多个关键字组合搜索。page
(可选):分页参数,表示当前页码,默认为1。size
(可选):分页参数,表示每页返回的商品数量,默认为10。sort
(可选):排序参数,支持按价格、销量等排序方式,默认为按综合排序。fields
(可选):指定返回的商品字段,默认为返回全部字段。...
(其他参数):根据实际需求可添加其他参数。
- 请求示例:
bash复制代码
GET https://api.souhaohuo.com/goods/search?keyword=手机&page=1&size=10&sort=price_asc
四、API接口响应说明
- 响应状态码:
200
:请求成功,返回商品列表数据。4xx
:客户端错误,如参数错误、请求格式错误等。5xx
:服务器内部错误。
- 响应数据格式:JSON
- 响应数据示例:
json复制代码
{
"code": 200,
"message": "搜索成功",
"data": [
{
"id": 12345,
"name": "华为Mate 40",
"price": 4999,
"sales": 10000,
"...": "其他商品字段"
},
{
"id": 67890,
"name": "小米11 Ultra",
"price": 5999,
"sales": 8000,
"...": "其他商品字段"
},
"...": "更多商品数据"
],
"total": 20000,
"pages": 2000
}