博物馆

分页获取博物馆信息列表

获取博物馆列表及轮播图。博物馆首页轮播图同样需要调用此接口获取，点击轮播图即打开对应的博物馆详情页面。

URL：/app-api/museum/article/getMuseumArticlePage
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
title	String	-	标题，搜索时传值
recommendBanner	Boolean	-	是否轮播图，`true` 获取轮播，`false` 获取列表
articleType	Long	必传	文章类型，`1`-博物馆，`2`-新闻，`3`-展讯
pageNo	Long	-	页码
pageSize	Long	-	页大小，默认 10，传 -1 不分页

使用说明

获取轮播图：recommendBanner=true，获取轮播图数据。
获取博物馆列表：根据 articleType 获取对应类型的列表。

请求示例

{
    "articleType": 1,
    "recommendBanner": true
}

响应示例

{
    "code": 0,
    "data": {
        "list": [
            {
                "id": 43,
                "articleType": 1,
                "title": "博物馆1",
                "author": "11",
                "picUrl": "https://example.com/image.png",
                "introduction": "",
                "browseCount": "0",
                "sort": 0,
                "status": 0,
                "recommendHot": false,
                "recommendBanner": true,
                "content": "<p>博物馆详情内容</p>",
                "createTime": 1729956061000,
                "museumProductRespVOList": [
                    {
                        "id": 43,
                        "museumId": 43,
                        "title": "藏品1",
                        "picUrl": "https://example.com/image.png",
                        "introduction": "",
                        "sort": 0,
                        "status": 0,
                        "content": "<p>藏品详情</p>",
                        "createTime": 1729956061000
                    }
                ]
            }
        ],
        "total": 1
    },
    "msg": "成功"
}

响应说明

博物馆字段：

参数	类型	说明
id	Long	博物馆编号
articleType	Long	文章类型，`1`-博物馆，`2`-新闻，`3`-展讯
title	String	标题
author	String	作者
picUrl	String	封面图/轮播图
introduction	String	简介
sort	Long	排序
status	Long	状态，`0`-开启，`1`-关闭
recommendBanner	Boolean	是否在轮播图展示
content	String	博物馆详情
createTime	Long	发布时间
browseCount	Long	浏览次数
shareTimes	Long	分享次数
commentTimes	Long	评论次数
collectTimes	Long	收藏次数
likeTimes	Long	点赞次数
isCollect	Boolean	当前用户是否收藏
isLike	Boolean	当前用户是否点赞
museumProductRespVOList	Array	藏品集合（仅博物馆类型返回）

藏品字段（museumProductRespVOList）：

参数	类型	说明
id	Long	藏品编号
museumId	Long	博物馆编号
title	String	藏品标题
picUrl	String	藏品封面图
introduction	String	藏品简介
sort	Long	排序
status	Long	状态，`0`-开启，`1`-关闭
content	String	藏品详情
createTime	Long	发布时间
browseCount	Long	浏览次数
shareTimes	Long	分享次数
commentTimes	Long	评论次数
collectTimes	Long	收藏次数
likeTimes	Long	点赞次数

获取博物馆详情信息

获取博物馆的详情数据，包含藏品列表。

URL：/app-api/museum/article/getMuseumArticleInfo
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
id	Long	必传	博物馆数据编号

请求示例

{
    "id": 40
}

响应示例

{
    "code": 0,
    "data": {
        "id": 43,
        "articleType": 1,
        "title": "博物馆1",
        "author": "11",
        "picUrl": "https://example.com/image.png",
        "introduction": "",
        "browseCount": "0",
        "sort": 0,
        "status": 0,
        "recommendHot": false,
        "recommendBanner": true,
        "content": "<p>博物馆详情内容</p>",
        "shareTimes": null,
        "commentTimes": 4,
        "collectTimes": 4,
        "likeTimes": 103,
        "createTime": 1729956061000,
        "museumProductRespVOList": [
            {
                "id": 43,
                "museumId": 43,
                "title": "藏品1",
                "picUrl": "https://example.com/image.png",
                "introduction": "",
                "sort": 0,
                "status": 0,
                "content": "<p>藏品详情</p>",
                "createTime": 1729956061000
            }
        ]
    },
    "msg": "成功"
}

响应说明

响应字段同「分页获取博物馆信息列表」中的博物馆字段及藏品字段。

获取博物馆藏品详情

获取单个藏品的详细信息。

URL：/app-api/museum/article/getMuseumProductInfo
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
id	Long	必传	藏品数据编号

请求示例

{
    "id": 40
}

响应示例

{
    "code": 0,
    "data": {
        "id": 40,
        "museumId": 43,
        "title": "藏品4",
        "picUrl": "https://example.com/image.png",
        "introduction": "",
        "sort": 1,
        "status": 0,
        "content": "<p>藏品详情内容</p>",
        "shareTimes": null,
        "commentTimes": null,
        "collectTimes": null,
        "likeTimes": 3,
        "createTime": 1729956061000
    },
    "msg": "成功"
}

响应说明

参数	类型	说明
id	Long	藏品编号
museumId	Long	博物馆编号
title	String	藏品标题
picUrl	String	藏品封面图
introduction	String	藏品简介
sort	Long	排序
status	Long	状态，`0`-开启，`1`-关闭
content	String	藏品详情
createTime	Long	发布时间
browseCount	Long	浏览次数
shareTimes	Long	分享次数
commentTimes	Long	评论次数
collectTimes	Long	收藏次数
likeTimes	Long	点赞次数

点赞/收藏

URL：/app-api/member/action/createLikesAction
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
articleId	Long	必传	文章/藏品编号
type	Long	必传	类型，`1`-资讯，`2`-博物馆

请求示例

{ "articleId": 100, "type": 2 }

响应示例

{ "code": 0, "data": null, "msg": "成功" }

响应说明

无返回数据，code = 0 即表示操作成功。

取消点赞/收藏

URL：/app-api/member/action/cancelLikesAction
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
articleId	Long	必传	文章/藏品编号
type	Long	必传	类型，`1`-资讯，`2`-博物馆

请求示例

{ "articleId": 100, "type": 2 }

响应示例

{ "code": 0, "data": null, "msg": "成功" }

响应说明

无返回数据，code = 0 即表示操作成功。

我的收藏-资讯列表

URL：/app-api/member/action/likesActionArticlePage
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
pageNo	Long	可选	页码，默认 1
pageSize	Long	可选	每页条数，默认 10

请求示例

{ "pageNo": 1, "pageSize": 10 }

响应示例

{
    "code": 0,
    "data": [
        {
            "id": 100,
            "articleType": 1,
            "title": "资讯标题",
            "author": "作者",
            "picUrl": "http://...",
            "introduction": "简介",
            "browseCount": "128",
            "sort": 0,
            "status": 0,
            "content": "<p>内容</p>",
            "shareTimes": 10,
            "commentTimes": 5,
            "collectTimes": 20,
            "likeTimes": 50,
            "createTime": 1729956061000
        }
    ],
    "msg": "成功"
}

响应说明

响应字段同「获取博物馆资讯列表」中的列表项。

我的收藏-博物馆列表

URL：/app-api/member/action/likesActionMuseumArticlePage
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
pageNo	Long	可选	页码，默认 1
pageSize	Long	可选	每页条数，默认 10

请求示例

{ "pageNo": 1, "pageSize": 10 }

响应示例

{
    "code": 0,
    "data": [
        {
            "id": 200,
            "articleType": 2,
            "title": "博物馆标题",
            "author": "作者",
            "picUrl": "http://...",
            "introduction": "简介",
            "browseCount": "256",
            "sort": 0,
            "status": 0,
            "content": "<p>内容</p>",
            "shareTimes": 8,
            "commentTimes": 3,
            "collectTimes": 15,
            "likeTimes": 30,
            "createTime": 1729956061000
        }
    ],
    "msg": "成功"
}

响应说明

响应字段同「首页获取博物馆资讯列表」中的列表项。

分页获取博物馆信息列表​

请求参数​

请求示例​

响应示例​

响应说明​

获取博物馆详情信息​

请求参数​

请求示例​

响应示例​

响应说明​

获取博物馆藏品详情​

请求参数​

请求示例​

响应示例​

响应说明​

点赞/收藏​

请求参数​

请求示例​

响应示例​

响应说明​

取消点赞/收藏​

请求参数​

请求示例​

响应示例​

响应说明​

我的收藏-资讯列表​

请求参数​

请求示例​

响应示例​

响应说明​

我的收藏-博物馆列表​

请求参数​

请求示例​

响应示例​

响应说明​

分页获取博物馆信息列表

请求参数

请求示例

响应示例

响应说明

获取博物馆详情信息

请求参数

请求示例

响应示例

响应说明

获取博物馆藏品详情

请求参数

请求示例

响应示例

响应说明

点赞/收藏

请求参数

请求示例

响应示例

响应说明

取消点赞/收藏

请求参数

请求示例

响应示例

响应说明

我的收藏-资讯列表

请求参数

请求示例

响应示例

响应说明

我的收藏-博物馆列表

请求参数

请求示例

响应示例

响应说明