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

# 获取用户对于单个文件有权设置的分享角色

| 属性 | 值 |
| --- | --- |
| HTTP 方法 | `GET` |
| 接口路径 | `/nd/api/share/share_role_forfile` |
| 所属分类 | 分享 API |

## 接口说明




#### URL 参数

| 参数 | 类型 | 说明（保留原资料的必填、默认值及范围） |
| --- | --- | --- |
| `file_id` | `string` | 文件 id |

#### 返回字段说明

```json
{"code":0,"roles":[],"success":true}
```

## 调用说明

- 调用前需完成 [获取 token](https://www.babel.cc/public/babelwiki/zh/api-post-api-token-do.html) 或相应免登录认证，并在请求 Header 中携带 `Authorization: Bearer <access_token>`。
- 参数和返回字段如因部署版本存在差异，应以实际私有云 API 文档和联调结果为准。
- 所属分类：分享 API。