钉钉开发文档

公告

更新时间: 2019-5-24

获取用户公告数据

企业使用此接口可获取指定人员的公告情况,在企业自定义工作首页进行公告轮播展示。列出用户当前有权限看到的10条公告。

请求方式:POST(HTTPS)
请求地址https://oapi.dingtalk.com/topapi/blackboard/listtopten?access_token=ACCESS_TOKEN
参数说明:

名称 类型 是否必须 示例值 描述
userid String 必须 manager01 用户id

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/blackboard/listtopten");
OapiBlackboardListtoptenRequest request = new OapiBlackboardListtoptenRequest();
request.setUserid("1226682231742708");
OapiBlackboardListtoptenResponse response = client.execute(request, accessToken);

返回结果

{
    "errcode":0,
    "errmsg":"成功",
    "blackboard_list":[
        {
                "gmt_create":"1497249913000",
                "title":"标题",
                "url":"https:\/\/app.dingtalk.com\/blackboard\/notice.html"
        }
    ]
}
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
blackboard_list 公告列表
└ gmt_create 创建时间
└ title 标题
└ url 跳转URL
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!