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

# 获取文件的分享 URL

`GET /nd/api/share/shareurl`

获取文件已开启的分享链接；应先按权限开启相应分享。使用 `Authorization: Bearer <access_token>` 鉴权。

## URL 参数

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `file_id` | string | 文件或文件夹 ID |
| `is_https` | number | 返回链接是否使用 HTTPS：1 为 HTTPS，0 为 HTTP；原文默认值为 0，生产环境应显式传 1 |

## 响应示例

```json
{
  "code": 0,
  "url": "https://files.example.com/share.do?s=<SHARE_TOKEN>",
  "success": true
}
```

示例域名和 token 仅用于展示结构。原始 PDF 示例存在重复拼接地址，应使用服务端实际返回的 `url`，不可按该错误示例手工拼接。若服务返回重复或不安全的地址，应排查部署配置。

得到链接不代表改变分享的密码、有效期或访问权限。链接失效、分享已关闭或无访问权限时，应先处理相应设置。参见[分享 API](https://www.babel.cc/public/babelwiki/zh/developer-api-sharing.html)。