3.7 商店数据接口 - getShops

优质

小牛编辑

127浏览

2023-12-01

商店数据接口 - GetShops

获取商店列表可根据名称模糊查询返回商店列表

Request Parameters

Parameter name	Type	Description	Required
search_word	string	名称模糊查询，如果为空，返回所有平台	No
per	int	分页每页容量，如果为空，默认为10，最大数应该小于200	No
page	int	分页第几页，如果为空，返回第一页	No

Response Elements

Parameter name	Type	Description
action	string	响应动作
shops	array	商店列表,每项参数可见下面 Response Item
total_count	int	根据过滤条件得到的品牌数
page_urls	array	分页相关，包含首页、上一页、当前页、下一页、最后一页URL,具体参见下面示例

Response Item

Parameter name	Type	Description
shop_id	int	商店id
shop_name	string	商店名称
platform_id	int	所在平台编号

示例

请求示例

http://open.syntun.cn/api/dq/GetShops
&search_word="小米"
&COMMON_PARAMS

响应示例

{
    "code": 1000,
    "msg": "OK",
    "data": {
        "action": "getShops",
        "brands": [
            {
                "shop_id": "828",
                "shop_name": "小米电器专营店",
                "platform_id": "4"
            },
            {
                "shop_id": "3247",
                "shop_name": "小米电器专营店",
                "platform_id": "5"
            },
            ...
        ],
        "total_count": 10,
        "page_urls": {
            "first": "COMMON_PARAMS&search_word=%E5%B0%8F%E7%B1%B3&page=1",
            "previous": null,
            "current": "COMMON_PARAMS&search_word=%E5%B0%8F%E7%B1%B3&page=1",
            "next": "COMMON_PARAMS&search_word=%E5%B0%8F%E7%B1%B3&page=2",
            "last": "COMMON_PARAMS&search_word=%E5%B0%8F%E7%B1%B3&page=2"
        }
    }
}