简要描述:

获取当前会员的以图搜款历史记录列表。

请求域名:

  • http://xx.com

请求路由:

/addons/yun_shop/api.php?i=商城ID&route=plugin.yz-supply-visual-search.frontend.history.index

请求参数说明:

参数名 类型 说明
page int 页码,默认 1
page_size int 每页数量,默认 20

返回示例:

正确时返回

{
    "result": 1,
    "msg": "成功",
    "data": {
        "list": [
            {
                "id": 12,
                "image": "https://example.com/uploads/visual-search/demo.jpg",
                "matched_goods_ids": [10001, 10002],
                "middleground_configuration_id": 3,
                "returned_goods_count": 2,
                "searched_imported_goods_count": 1,
                "searched_unimported_goods_count": 1,
                "new_imported_goods_count": 0,
                "status": 1,
                "created_at": 1775721600,
                "created_at_text": "2026-04-08 12:00:00"
            },
            {
                "id": 11,
                "image": "https://example.com/uploads/visual-search/demo-2.jpg",
                "matched_goods_ids": [],
                "middleground_configuration_id": 3,
                "returned_goods_count": 0,
                "searched_imported_goods_count": 0,
                "searched_unimported_goods_count": 0,
                "new_imported_goods_count": 0,
                "status": 2,
                "created_at": 1775718000,
                "created_at_text": "2026-04-08 11:00:00"
            }
        ],
        "pagination": {
            "current_page": 1,
            "per_page": 20,
            "total": 2,
            "last_page": 1
        }
    }
}

返回参数说明:

参数名 类型 说明
result int 接口状态,1 表示成功
msg string 返回提示
data.list array 历史记录列表
data.list[].id int 搜索记录 ID
data.list[].image string 搜索图片地址
data.list[].matched_goods_ids array 命中的供应链商品 ID 集合
data.list[].middleground_configuration_id int 中台配置 ID
data.list[].returned_goods_count int 返回商品总数
data.list[].searched_imported_goods_count int 搜索时已导入商品数量
data.list[].searched_unimported_goods_count int 搜索时未导入商品数量
data.list[].new_imported_goods_count int 后续新增导入商品数量
data.list[].status int 记录状态,0 失败,1 成功,2 无结果
data.list[].created_at int 创建时间戳
data.list[].created_at_text string 创建时间文本
data.pagination object 分页信息
data.pagination.current_page int 当前页码
data.pagination.per_page int 每页数量
data.pagination.total int 总记录数
data.pagination.last_page int 最后一页页码