生成项目发图链接
使用身份：子管理员个人身份 Token；
业务背景：项目图纸模型，需要对外生成分享链接，控制访问有效期、密码、下载次数、下载权限；
前置条件： ①文件已经上传同步，拿到 fileId； ②文件归属项目空间 fileScope=project； ③子管理员账号已同步 SView，拥有分享权限； ④项目已经创建，拿到 projectCode。
详细调用流程
- 使用子管理员 integrationId 获取个人 access_token，grant_type=mobile。
- 创建分享发图链接接口 接口：
POST /login‑register/open‑api/documents/share‑url- Header：Bearer 子管理员 access_token + 公共 Header；json；
- Body 入参：
- fileId：SView 内部文件 ID；
- fileScope：固定填
project； - projectCode：集成开发方外部项目编码；
- extParams 扩展 Map（全部 key 可选，不填取服务端默认）：
表格
| key | 说明 |
|---|---|
| permanent | 是否永久链接 true/false； |
| validDays | 有效期天数，permanent=false 必填； |
| accessMode | 访问模式，固定填LOGIN_REQUIRED； |
| passwordEnabled | 是否开启访问密码 true/false； |
| password | 开启密码后传入； |
| commentEnabled | 是否允许评论； |
| downloadMode | DIRECT 直接下载 / APPROVAL_REQUIRED 申请下载； |
| downloadLimitType | LIMITED 有限次数 / UNLIMITED 无限制； |
| downloadLimitCount | LIMITED 模式必填，最大下载次数； |
- 返回 data 中
shareUrl对外访问链接，shareId分享编号。
集成开发方留存关键数据
shareUrl 对外访问链接、shareId。
高频踩坑说明
- 使用普通用户 Token 调用，鉴权报错，必须子管理员个人 Token；
- permanent=false 但是不填 validDays，业务报错；downloadLimitType=LIMITED 不填 count 报错。