创建公告旧版SDK
更新于 2023-10-11
钉钉提供了公告应用，可以由企业的主管理员（或是子管理员）发送给全公司（指定部门、指定人员）的通知性文章，如公司规章制度、放假信息等。
调用本接口，创建标题为正式公告1的公告，本接口的参数coverpic_mediaid对应的是下图中的封面图片。
接口调用成功后，可以在公告列表查看新创建的公告，如下图所示。
权限
服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。
应用类型 | 是否可调用 | 权限申请方式 | API Explorer调试 |
企业内部应用 | 是 | 钉钉公告管理权限 | |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
基本信息
请求方式：POST
请求地址：https://oapi.dingtalk.com/topapi/blackboard/create
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 6d1bxxxx | 调用该接口的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
create_request | OapiCreateBlackboardVo | 是 | 请求对象。 | |
operation_userid | String | 是 | manager01 | 操作人的userId，必须是公告管理员。 |
author | String | 否 | 杨xx | 公告作者。 |
private_level | Number | 否 | 0 | 保密等级：
|
ding | Boolean | 否 | false | 是否发送应用内钉提醒：
|
blackboard_receiver | BlackboardReceiverOpenVo | 是 | 公告接收人。 | |
deptid_list | Number[] | 否 | [1] | 接收部门ID列表，最大的列表长度为20。 |
userid_list | String[] | 否 | ["manager02"] | 接收人userId列表，最大的列表长度为1000。 |
title | String | 是 | 入职须知 | 公告标题。 |
push_top | Boolean | 否 | true | 公告是否置顶。
|
content | String | 是 | 欢迎加入我们的大家庭 | 公告内容。 |
category_id | String | 否 | 987uy66t5rt54er | 公告分类ID。 |
coverpic_mediaid | String | 否 | @lADPDeC2ufXOeRzMqM0BLA | 封面图，格式为 可以通过上传媒体文件接口上传图片，获取media_id参数值。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
result | Boolean | true | 是否创建成功。
|
success | Boolean | true | 本次调用是否成功。
|
errcode | Number | 0 | 返回码。 |
request_id | String | roz884n3k7rf | 请求ID。 |
示例
请求示例（HTTP）
请求正文
请求示例（JAVA SDK）
返回示例
