分页查询公告列表

分页查询公告列表

请求说明

请求地址	https://openapi.wps.cn/v7/announce/announces
请求方法	GET
签名方式	KSO-1
权限要求	查询公告（应用授权） kso.announce.read 查询公告（用户授权）kso.announce.read

请求头（Header）

Header 名称	参数类型	是否必填	说明
Content-Type	string	是	使用：application/json
X-Kso-Date	string	是	RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》
Authorization	string	是	授权凭证，格式为：Bearer {access_token}

查询参数（Query）

名称	类型	是否必填	说明
is_top	bool	否	置顶标识：true-返回置顶公告，false返回普通公告;查询置顶公告时不需要传分页参数
page_size	int64	否	0 <= page <= 100, 分页大小
page_token	string	否	<= 1024 characters,分页token（第一次请求不传）
with_total	bool	否	是否返回总数

请求地址示例

[GET] https://openapi.wps.cn/v7/announce/announces?page_size=10&page_token=0

响应体（Response）

名称	类型	说明
code	integer	code
more	object	更多的错误信息
msg	string	msg
data	object	信息返回
∟ items	object[]	公告列表
∟∟ app_id	string	应用ID
∟∟ cover	string	封面图store_key
∟∟ created_by	object	创建者信息
∟∟∟ id	string	创建者wps_uid
∟∟∟ name	string	创建者名称
∟∟ expire_time	int64	过期时间戳
∟∟ id	string	公告ID
∟∟ is_top	boolean	是否置顶
∟∟ publish_time	int64	发布时间戳
∟∟ title	string	公告标题
∟ next_page_token	string	分页游标（用于下一页查询）
∟ total	int64	总数

响应体示例

{
  "data": {
    "items": [
      {
        "app_id": "AK20211123JLJNIE",
        "cover": "5A51FBBANDAwMDMyNTA1MTpkb1ZKNVUyWkIxTXJ4dmVnakNROHJ4R0Nnb0dhRVRVS3U=",
        "created_by": {
          "id": "pzveBn5",
          "name": "超管"
        },
        "expire_time": 0,
        "id": "23367",
        "is_top": false,
        "publish_time": 1742547315,
        "title": "title-公告-1742547315145"
      },
      {
        "app_id": "AK20211123JLJNIE",
        "cover": "5A51FBBANDAwMDMyNTA1MTpkb1ZKNVUyWkIxTXJ4dmVnakNROHJ4R0Nnb0dhRVRVS3U=",
        "created_by": {
          "id": "pzveBn5",
          "name": "超管"
        },
        "expire_time": 0,
        "id": "23323",
        "is_top": false,
        "publish_time": 1742542899,
        "title": "title-公告-1742542898775"
      },
      {
        "app_id": "AK20211123JLJNIE",
        "cover": "5A51FBBANDAwMDMyNTA1MTpkb1ZKNVUyWkIxTXJ4dmVnakNROHJ4R0Nnb0dhRVRVS3U=",
        "created_by": {
          "id": "pzveBn5",
          "name": "超管"
        },
        "expire_time": 0,
        "id": "23324",
        "is_top": false,
        "publish_time": 1742542899,
        "title": "title-公告-1742542898930"
      },
      {
        "app_id": "AK20211123JLJNIE",
        "cover": "5A51FBBANDAwMDMyNTA1MTpkb1ZKNVUyWkIxTXJ4dmVnakNROHJ4R0Nnb0dhRVRVS3U=",
        "created_by": {
          "id": "pzveBn5",
          "name": "超管"
        },
        "expire_time": 0,
        "id": "23322",
        "is_top": false,
        "publish_time": 1742541080,
        "title": "title-公告-1742541079804"
      },
      {
        "app_id": "AK20211123JLJNIE",
        "cover": "5A51FBBANDAwMDMyNTA1MTpkb1ZKNVUyWkIxTXJ4dmVnakNROHJ4R0Nnb0dhRVRVS3U=",
        "created_by": {
          "id": "pzveBn5",
          "name": "超管"
        },
        "expire_time": 0,
        "id": "23321",
        "is_top": false,
        "publish_time": 1742541079,
        "title": "title-公告-1742541079461"
      }
    ],
    "next_page_token": "6",
    "total": 10
  },
  "code": 0,
  "more": {},
  "msg": "string"
}