获取公告ID列表

POST

/topapi/blackboard/listids

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

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

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

权限

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

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	读取钉钉公告微应用数据的权限	调试
第三方企业应用	否	—	—
第三方个人应用	否	—	—

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://oapi.dingtalk.com/topapi/blackboard/listids?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
        "query_request":{
                "operation_userid":"manager4220",
                "page":1,
                "page_size":10,
                "start_time":"2019-10-07 10:10:10",
                "end_time":"2019-11-07 10:10:10",
                "category_id":"9i9u7y7g6t65"
        }
}'

响应示例

{
    "errcode": 0,
    "result": [
        "72b4f87d27e815f6fecxxxx"
    ],
    "success": true,
    "request_id": "pxxm7ylvmppr"
}

修改于 2024-01-16 06:10:55

获取公告详情

获取公告分类列表

获取公告ID列表

权限#

请求参数

返回响应

权限