获取可以关注文件的用户列表，并且标记已关注文件的用户

GET /nd/api/file/user_can_focusfile

URL 查询参数

参数	类型	说明
`file_id`	`string`	必填；文件 ID

表格可左右滚动查看

返回信息

成功响应包含 users 数组。isFocusFile 为整数：0 表示该用户未关注本次查询的文件，1 表示已关注。

以下为样例中出现的字段与 JSON 类型。姓名、邮箱、手机号、工号、用户和部门标识及时间已替换为示例值；状态码未提供完整枚举的字段仅记录样例值。

字段	样例类型	说明
`id`	`string`	用户 ID。
`babelId`	`string` 或 `null`	工号；可为空。
`name`	`string`	用户显示名称。
`email`	`string`	邮箱。
`sex`	`int`	性别代码；样例出现 `0`、`1`。
`phone`	`string` 或 `null`	手机号；样例包含掩码字符串及空值。
`registered`	`int`	注册相关标记；样例为 `1`。
`frozen`	`int`	冻结相关标记；样例为 `0`。
`status`	`int`	状态代码；样例为 `0`，不推定完整枚举。
`registerTime`	`string`	注册时间，样例使用带 `Z` 的 UTC 日期时间字符串。
`lastAccessTime`	`string`	最近访问时间，样例使用带 `Z` 的 UTC 日期时间字符串。
`maxDownloadSpeed`	`int`	下载速度相关数值；样例为 `0`，未提供单位及零值语义。
`extraAttr`	`int`	附加属性值；样例出现 `0`、`1`，业务含义未提供。
`isFocusFile`	`int`	`0` 未关注该文件；`1` 已关注该文件。
`departments`	`array`	用户所属部门列表，可包含多个部门。
`departments[].departmentId`	`string`	部门 ID。
`departments[].departmentName`	`string`	部门名称。

表格可左右滚动查看

成功示例同时展示已关注和未关注的用户：

{
  "code": 0,
  "users": [
    {
      "id": "2001",
      "babelId": "member-example",
      "name": "示例成员甲",
      "email": "member-a@example.com",
      "sex": 0,
      "phone": "000****0000",
      "registered": 1,
      "frozen": 0,
      "status": 0,
      "registerTime": "2026-01-01T00:00:00.000Z",
      "lastAccessTime": "2026-01-02T00:00:00.000Z",
      "maxDownloadSpeed": 0,
      "extraAttr": 1,
      "isFocusFile": 1,
      "departments": [
        {"departmentId": "3001", "departmentName": "示例部门甲"}
      ]
    },
    {
      "id": "2002",
      "babelId": null,
      "name": "示例成员乙",
      "email": "member-b@example.com",
      "sex": 1,
      "phone": null,
      "registered": 1,
      "frozen": 0,
      "status": 0,
      "registerTime": "2026-01-01T00:00:00.000Z",
      "lastAccessTime": "2026-01-03T00:00:00.000Z",
      "maxDownloadSpeed": 0,
      "extraAttr": 0,
      "isFocusFile": 0,
      "departments": [
        {"departmentId": "3002", "departmentName": "示例部门乙"},
        {"departmentId": "3003", "departmentName": "示例部门丙"},
        {"departmentId": "3004", "departmentName": "示例部门丁"}
      ]
    }
  ],
  "success": true
}

失败：

{"code":2,"success":false}

isFocusFile 是用户相对于本次 file_id 的关注状态，不是其是否关注过任意文件。此结构属于本接口，不据此改写其他用户列表接口。

调用说明

使用 Authorization: Bearer <access_token>。GET 参数放在 URL 查询串中，普通业务 POST 使用 JSON 请求体。先校验 HTTP 状态，再检查业务结果。数组标记与含糊的类型应按服务端实际约定联调，不应凭示例补造字段。

认证说明 · API 概览