获取公告ID列表旧版SDK

更新于 2023-01-18

接口调用量说明使用当前 API 接口会消耗每月计量 API 调用额度，请登录开发者后台-资源管理查看企业所有的用量权益。如您已经收到用量预警，或调用额度无法满足使用，您可以购买应用开发增购包（独立购）提升当月调用总额度。

调用本接口，获取企业某公告分类下所有未删除公告的ID列表。

例如，测试组织下共发送2个公告，分别为正式工作1和公告测试-普通员工不可查看。调用本接口返回公告的ID列表，如下图所示。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

请求方式：POST

请求地址：https://oapi.dingtalk.com/topapi/blackboard/listids

名称

类型

是否必填

示例值

描述

access_token

String

是

6d1bxxxx

调用该接口的应用凭证。

名称	类型	是否必填	示例值	描述
query_request	OapiBlackboardQueryVo	是		请求对象。
operation_userid	String	是	manager4220	操作人userId，必须是公告管理员。
page_size	Number	是	10	分页大小，从1开始不超过30，且必须为正整数。
start_time	Date	否	2019-10-07 10:10:10	开始时间。如果只传start_time，start_time距当前时间不能超过180天。如果传start_time和end_time，时间间隔不能超过180天。如果不传start_time和end_time，默认获取近一个月内的公告信息。
end_time	Date	否	2019-11-07 10:10:10	结束时间。如果只传start_time，start_time距当前时间不能超过180天。如果传start_time和end_time，时间间隔不能超过180天。如果不传start_time和end_time，默认获取近一个月内的公告信息。
page	Number	是	1	页码，从1开始且必须为正整数。
category_id	String	否	9i9u7y7g6t65	分类ID，可以通过获取公告分类列表接口获取id参数值。

请求示例（HTTP）

请求正文

请求示例（JAVA SDK）

返回示例

这篇文档是否有帮助？

本页内容