文件上传‑项目空间

使用身份：项目参与用户个人 Token；该用户必须已经加入目标项目。
业务背景：集成开发方业务系统模型图纸归属某个业务项目，需要上传到 SView 对应的项目空间；同项目其他成员可以按权限查看这份文件。 
前置条件： ①项目已经通过场景 2 创建完成，拿到 projectCode； ②调用接口的用户已经被加入项目； ③本地待上传模型文件就绪。

详细调用流程

1. 获取参与项目的用户个人 access_token，mobile=INTEGRATION@{用户integrationId}。

1. 获取预签名上传地址 接口：POST /dms/common/oss/uploadUrl
   • category 传entProjectSpace；objectName 带文件后缀；
   • 返回 uploadUrl、relativePath。

1. PUT 二进制上传文件到 uploadUrl，HTTP200 代表存储上传成功。

1. 同步文件元信息落库 接口：POST /login‑register/open‑api/documents/sync‑file‑meta
   • Header：Bearer 用户 access_token + 公共 Header；
   • Body：
     • fileScope 设置为project；必须传入 projectCode（外部项目编码）；
     • dir 填写前面拿到的 relativePath；
     • pfolderId 填写项目空间文件夹 ID，根目录填 0；
     • fileMd5、fileSize、originalFilename、fileName、uploadStatus="0"；autoUpgrade 按需配置 y/n；
   • 成功返回 fileId。

集成开发方留存关键数据

fileId，后续预览、分享使用。

高频踩坑说明

1. fileScope=project 场景漏传 projectCode，接口业务报错；