Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
服务端API
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
  1. 公告
  • 获取用户可查看的公告
    POST
  • 获取公告分类列表
    POST
  • 获取公告ID列表
    POST
  • 获取公告详情
    POST
  • 创建公告
    POST
  • 更新公告
    POST
  • 删除公告
    POST
  1. 公告

获取公告详情

POST
http://127.0.0.1/topapi/blackboard/get
服务端API/公告
最后修改时间:2022-08-30 09:19:21
责任人:未设置

说明#

调用该接口根据公告ID获取未删除的公告的详情。
服务地址:https://oapi.dingtalk.com

权限#

服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型是否支持调用权限申请方式API Explorer调试
企业内部应用是开发者后台申请调试
第三方企业应用否——
第三方个人应用否——

请求参数

Query 参数
access_token
string 
必需
调用服务端接口的授权凭证。企业内部应用可通过调用access_token接口获得。
示例值:
6d1bxxxx
Body 参数application/json
blackboard_id
string 
必需
公告id,可以通过获取公告ID列表接口获取。
operation_userid
string 
必需
操作人userid。
示例
{
  "operation_userid": "manager4220",
  "blackboard_id": "9uiuihhgui989huh"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/topapi/blackboard/get?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "operation_userid": "manager4220",
    "blackboard_id": "9uiuihhgui989huh"
}'

返回响应

🟢200成功
application/json
Body
result
object 
公告详情。
可选
id
string 
公告ID。
可选
author
string 
公告作者。
可选
title
string 
公告标题。
可选
content
string 
公告内容。
可选
category_id
string 
公告分类ID。
可选
private_level
number 
可选
保密等级:0:普通公告20:保密公告
depname_list
array[string]
接收部门列表。
可选
username_list
array[string]
接收人列表。
可选
gmt_create
string 
公告创建时间。
可选
gmt_modified
string 
公告最后修改时间。
可选
read_count
number 
已读人数。
可选
unread_count
number 
未读人数。
可选
coverpic_url
string 
可选
封面图的url链接。
success
boolean 
本次调用是否成功。
可选
errcode
number 
返回码。
可选
request_id
string 
请求ID。
可选
示例
{
  "result": {
    "id": "string",
    "author": "string",
    "title": "string",
    "content": "string",
    "category_id": "string",
    "private_level": 0,
    "depname_list": [
      "string"
    ],
    "username_list": [
      "string"
    ],
    "gmt_create": "string",
    "gmt_modified": "string",
    "read_count": 0,
    "unread_count": 0,
    "coverpic_url": "string"
  },
  "success": true,
  "errcode": 0,
  "request_id": "string"
}
上一页
获取公告ID列表
下一页
创建公告
Built with