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

# 邀请人员参与分享

`POST /nd/api/share/invite_share`

## POST 请求体参数

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `file_id` | `string` | 必填；文件或文件夹 ID |
| `share_role` | `string` | 必填；本次邀请统一使用的角色 ID |
| `emails` | `string[]` | 邀请邮箱列表 |
| `phones` | `string[]` | 邀请手机号列表 |

## 返回信息

原文列出的字段：`code`, `success`.

可通过邮箱或手机号邀请外部成员；被邀请者登录或通过验证码确认身份。原文用 emails[]、phones[] 表示数组，实际提交格式须与服务端约定。此版本未列部门参数；界面中的部门递归邀请能力不等于接口支持未文档化的 department_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)
