文件上传

接口说明

上传文件并返回资源ID

接口地址

POST /api/resource/upload

请求头

Content-Type: multipart/form-data

请求参数

字段名	类型	必填	说明
file	MultipartFile	是	上传的文件
data	String	是	JSON字符串(需加密)
channel	String	是	渠道号
requestTime	Long	是	请求时间戳
key	String	是	SM2加密的SM4密钥
salt	String	是	SM2加密的SM4 IV
sign	String	是	请求签名

data 解密后内容

{
  "projectId": 1,
  "memberId": 1000001,
  "resourceType": 22,
  "fileDigest": "文件摘要(SHA256)"
}

resourceType 说明

类型码	说明
1	营业执照
2	身份证正面
3	身份证反面
22	信用报告
23	订单汇总

响应参数 (data 解密后)

{
  "code": 0,
  "message": "成功",
  "data": {
    "resourceId": 1027129293002048,
    "fileName": "test_1.pdf",
    "fileSize": 962914,
    "storagePath": "1/22/1000001/20251226/23cba11664194ddab30ece1222f1918b.pdf",
    "resourceUrl": "https://lilit-dev.oss-cn-hangzhou.aliyuncs.com/1/22/1000001/20251226/23cba11664194ddab30ece1222f1918b.pdf?Expires=1766732997&OSSAccessKeyId=LTAI5tHvWU5mqBX6cj9MESWL&Signature=zaJNCIkg5Q8uhvY%2BPC9XOvWfzP4%3D",
    "pluginResults": {
      "OCR_BASIC": {
        "code": 0,
        "message": "OCR识别完成（示例实现）",
        "data": {
          "fileName": "test_1.pdf",
          "contentType": "application/pdf",
          "text": "这是OCR识别的示例文本内容",
          "confidence": 0.95,
          "timestamp": 1766729397120
        }
      }
    }
  }
}

响应字段说明

字段名	类型	说明
resourceId	Long	资源ID（用于后续接口引用）
fileName	String	文件名
fileSize	Long	文件大小（字节）
storagePath	String	存储路径
resourceUrl	String	资源访问URL（带签名的临时访问链接）
pluginResults	Object	插件处理结果（可选，取决于资源类型）
pluginResults.OCR_BASIC	Object	OCR识别结果（针对图片或PDF文件）
pluginResults.OCR_BASIC.code	Integer	插件执行状态码：0-成功
pluginResults.OCR_BASIC.message	String	插件执行信息
pluginResults.OCR_BASIC.data	Object	OCR识别数据
pluginResults.OCR_BASIC.data.fileName	String	识别的文件名
pluginResults.OCR_BASIC.data.contentType	String	文件MIME类型
pluginResults.OCR_BASIC.data.text	String	OCR识别的文本内容
pluginResults.OCR_BASIC.data.confidence	Double	识别置信度（0-1之间）
pluginResults.OCR_BASIC.data.timestamp	Long	识别时间戳（毫秒）

插件说明

OCR_BASIC 插件

系统会自动对以下类型的文件执行OCR识别：

• 图片文件：JPG, PNG, BMP 等
• PDF文件：包含文本或图片的PDF

作用：提取文件中的文本内容，用于后续的业务处理和审核

返回数据：

• text：识别出的完整文本内容
• confidence：识别置信度（0-1，越接近1表示识别越准确）
• timestamp：OCR处理完成的时间戳

注意事项

1. 文件大小限制：单个文件最大支持 10MB
2. 文件格式：支持常见格式（PDF、JPG、PNG、BMP 等）
3. resourceUrl 有效期：返回的 URL 为临时访问链接，有效期有限（通常为1小时），长期保存请使用 resourceId
4. resourceId 用途：在其他接口（如创建成员、授信等）中引用上传的文件
5. pluginResults 可选性：并非所有文件都会有插件处理结果，取决于文件类型和资源类型配置