创建公告

POST

/topapi/blackboard/create

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

调用本接口，创建企业公告。

钉钉提供了公告应用，可以由企业的主管理员（或是子管理员）发送给全公司（指定部门、指定人员）的通知性文章，如公司规章制度、放假信息等。

调用本接口，创建标题为正式公告1的公告，本接口的参数coverpic_mediaid对应的是下图中的封面图片。

接口调用成功后，可以在公告列表查看新创建的公告，如下图所示。

权限

服务端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/create?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
        "create_request":{
                "push_top":true,
                "operation_userid":"manager4220",
                "ding":false,
                "author":"杨xx",
                "private_level":0,
                "blackboard_receiver":{
                        "deptid_list":[1],
                        "userid_list":["mamanger123"]
                },
                "category_id":"987uy66t5rt54er",
                "coverpic_mediaid":"@lADPDe7sxUSgK9LNA-LNBZQ",
                "title":"入职须知",
                "content":"欢迎加入我们的大家庭"
        }
}'

响应示例

{
    "errcode": 0,
    "result": true,
    "success": true,
    "request_id": "roz884n3k7rf"
}

修改于 2024-01-16 06:08:23

权限申请

删除公告

创建公告

权限#

请求参数

返回响应

权限