单个文件上传

接口：magneto/api/v1/files
Method：POST
内容类型：multipart/form-data
接口说明：云简电子档案获取API访问令牌
其他补充信息：认证授权

参数:

请求参数

参数名	类型	必填	描述	示例值
file	MultipartFile	是	上传的文件	file.pdf
file_name	String	否	自定义文件名）	"合同文档.pdf"
file_desc	String	否	文件描述信息	"2024年度销售合同"
file_type	String	否	文件类型（不提供时自动识别）	"PDF"
archive_type_code	String	是	档案类型代码	"F003"
source_code	String	否	来源代码，标识文件来源系统	"S001"

返回参数

字段名	类型	描述
fileNum	String	全局唯一文件编号，用来创建资料的时候进行关联的编码
fileHash	String	文件SHA256哈希值，用于重复文件检测
fileSize	Long	文件大小（字节）
fileUrl	String	文件存储URL
existing	Boolean	是否为已存在文件（true=重复文件，false=新文件）

示例：

请求数据

cURL 示例

curl --location --request POST 'https://devapi.cloudpense.com/magneto/api/v1/files' \
--header 'token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjb21wYW55X2lkIjozODA5LCJleHAiOjE3NjM4MDY1MTksImNsaWVudF9pZCI6IkFyY2hpdmVFeHRlbnNpb24iLCJzb3VyY2VfbmFtZSI6IlNBUCJ9.8uqVNo9Mi0yc3lPIZMth7r1ERCDmdhOfj0Lek7d1j90' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--form 'file=@"C:\\Users\\pc\\Downloads\\prefiling_3809_e34d5fba-9814-4908-b7de-5c4dd3c56796 (1).pdf"' \
--form 'source_code="S001"' \
--form 'file_name="支付单附件.pdf"' \
--form 'file_type="pdf"' \
--form 'file_desc="测试附件上传"' \
--form 'archive_type_code="F003"'

返回数据

{
  "resCode": 200000,
  "resMsg": "文件上传成功",
  "data": {
    "fileNum": "FILE2025112286435527",
    "fileHash": "E12D84FBDF243408EF833C008EB86424FC4F42B053EF28C688D6BA62CF25DFE0",
    "fileSize": 116267,
    "fileUrl": "prefiling/3809/7a88d45c-318d-414e-86ad-160935ce6c6d.pdf",
    "existing": false
  }
}

results matching ""

No results matching ""