分页查询 Banner 信息

更新时间：2023-06-15 05:12:12

本文介绍分页查询 Banner 信息的 API。

接口描述

根据语言，栏目状态等参数以分页的方式查询 Banner 信息。

接口地址

GET: /v1.0/iot-03/app-contents/banners

请求参数

参数名	类型	参数位置	是否必填	说明
category_id	String	query	false	栏目 ID
lang	String	query	false	语言
banner_state	Integer	query	false	Banner 状态： 1：未发布 2：已发布 3：已下架
page_size	Integer	query	true	每页数量
page_no	Integer	query	true	页码
schema	String	query	false	App Schema

返回参数

参数名	类型	说明
result	PageResult	Banner 信息

result 说明

参数名	类型	说明
page_info	PageInfo	分页信息
datas	List	Banner 信息

datas 说明

参数名	类型	说明
banner_id	String	Banner ID
title	String	标题
category_id	String	栏目 ID
pic_url	String	图片地址
title_lang_info	List	标题多语言
banner_state	Integer	Banner 状态： 1：未发布 2：已发布 3：已下架
link	String	链接地址
create_time	Long	创建时间
update_time	Long	更新时间
creator	String	创建人
modifier	String	更新人
publish_time	Long	发布时间
order	Integer	顺序
view_count	Integer	阅读数
schema	String	App Schema

page_info 说明

参数名	类型	说明
page_count	Integer	总页数
page_size	Integer	每页大小
total	Integer	总数
page_no	Integer	第几页

title_lang_info 说明

参数名	类型	说明
lang	String	语言
value	String	多语言值

请求示例

GET: /v1.0/iot-03/app-contents/banners?schema=abc&page_no=1&page_size=10

返回示例

{
    "result": {
        "datas": [
            {
                "schema": "123",
                "creator": "bsh1618231457224vDlX",
                "create_time": 1630308804188,
                "banner_id": "1432245049193660471",
                "title_lang_info": [
                    {
                        "lang": "zh",
                        "value": "测试 "
                    }
                ],
                "modifier": "bsh1618231457224vDlX",
                "link": "https://iot.tuya.com",
                "update_time": 1630308804188,
                "category_id": "1430536540064317471",
                "publish_time": 1630308804188,
                "pic_url": "suramar/16303087612b996f9251f.png",
                "banner_state": 2,
                "view_count": 0,
                "order": 0
            }
        ],
        "page_info": {
            "page_no": 1,
            "total": 1,
            "page_count": 1,
            "page_size": 10
        }
    },
    "t": 1630309904211,
    "success": true
}

错误码

参考错误码。

上一篇下架 Banner

下一篇更新 Banner