---
id: "zh/api-get-nd-api-file-user-can-focusfile"
title: "获取可以关注文件的用户列表，并且标记已关注文件的用户"
language: "zh"
description: "GET /nd/api/file/user_can_focusfile：获取可以关注文件的用户列表，并且标记已关注文件的用户 接口说明，包含路径、方法、参数和返回信息。"
canonical_url: "https://www.babel.cc/public/babelwiki/zh/api-get-nd-api-file-user-can-focusfile.html"
markdown_url: "https://www.babel.cc/public/babelwiki/ai/zh/api-get-nd-api-file-user-can-focusfile.md"
alternates: {"en": "https://www.babel.cc/public/babelwiki/ai/en/api-get-nd-api-file-user-can-focusfile.md", "zh": "https://www.babel.cc/public/babelwiki/ai/zh/api-get-nd-api-file-user-can-focusfile.md"}
reading_note: "文档记录不等于当前部署能力；以实际版本、授权模块与配置为准。保留原文的可选、限制及待确认说明，勿补猜接口。 / Documentation is not a guarantee for every deployment. Preserve optional-module requirements, limitations and unresolved API contracts."
---

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

`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` | 部门名称。 |

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

```json
{
  "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
}
```

失败：

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

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

## 调用说明

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

[认证说明](https://www.babel.cc/public/babelwiki/zh/developer-api-auth.html) · [API 概览](https://www.babel.cc/public/babelwiki/zh/developer-api-overview.html)