巴别鸟巴别鸟文档

发布公告

属性 值
HTTP 方法 POST
接口路径 /nd/api/enterprise/broadcast
所属分类 企业 API

接口说明

POST 请求体参数

参数 类型 说明(保留原资料的必填、默认值及范围)
title string 公告内容字符串(必填)
content string 内容(必填)
target_users string[] 指定接收用户的 ID,使用 JSON 数组;不指定用户时传 []。
target_deps string[] 目标部门 ID,使用 JSON 数组;接收范围包含这些部门及其子部门的成员。不指定部门时传 []。

表格可左右滚动查看

target_users 与 target_deps 都为空数组时,不发送公告。至少一个数组非空时,将指定用户与目标部门中的用户合并后发送。请显式传入这两个 JSON 数组,参数名不带 [],也不要将整个数组编码成字符串。

两者都为空,不发送:

{
  "title": "示例公告",
  "content": "示例内容",
  "target_users": [],
  "target_deps": []
}

合并指定用户和部门成员后发送(ID 为示例值):

{
  "title": "示例公告",
  "content": "示例内容",
  "target_users": ["2001"],
  "target_deps": ["3001"]
}

返回字段说明

{"code":0,"success":true}

调用说明

  • 调用前需完成 获取 token 或相应免登录认证,并在请求 Header 中携带 Authorization: Bearer <access_token>。
  • 参数和返回字段如因部署版本存在差异,应以实际私有云 API 文档和联调结果为准。
  • 所属分类:企业 API。

收件范围确认

空数组不代表全员。仅 target_users 非空时发送给指定用户;仅 target_deps 非空时发送给目标部门及其子部门中的用户;两者非空时合并接收范围;两者都为空时不发送。这里说明的是显式传入数组时的行为,不将省略参数等同于空数组。

巴别鸟企业网盘文档内容会随产品版本、授权模块和部署配置更新;具体能力以实际部署与管理员配置为准。

本页 Markdown · AI 文档目录