分页查询 Banner 信息

更新时间:2023-06-20 12:34:14下载pdf

本文介绍分页查询 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 }

错误码

参考 错误码