签盾开放平台-公有云版
  1. 本地文件上传
签盾开放平台-公有云版
  • 快速入手
    • 接入流程
    • 业务流程
  • 帮助文档
    • 基本概念
    • 合同状态说明
    • 印章指定位置
    • 静默签使用说明
    • 常见错误码
    • 回调接入文档
  • 开发前必读
    • 公共请求格式
    • 移动端(Android,IOS,微信小程序,H5)--接入
  • 认证授权
    • 用户认证&授权流程
    • 个人认证&授权
      • 获取个人认证&授权链接
      • 查询个人认证信息
      • 查询个人授权信息
    • 企业认证&授权
      • 获取企业认证&授权链接
      • 查询企业认证信息
      • 查询企业授权信息
  • 合同签署
    • 文件处理
      • 本地文件上传
        • 上传合同文件
          POST
        • 上传合同附件
          POST
      • 模版文件使用
        • 基于模板创建合同文件
      • 获取文件关键字坐标
        POST
    • 合同发起
      • 发起合同
    • 合同操作
      • 获取参与方操作链接(签署链接)
      • 催办合同签署
      • 撤回合同
    • 合同查询
      • 查询企业合同类目
      • 获取合同预览链接
      • 查询合同详情
      • 分页查询合同列表
      • 查询合同存证信息
      • 下载合同文件及合同附件
  • 审批管理
    • 审批流程使用场景
    • 列表查询用户可用的审批流程
      GET
    • 分页查询审批状态合同列表
      POST
    • 查询签署用印审批详情
      GET
    • 查询发起合同审批详情
      GET
    • 获取审批操作链接
      POST
  • 企业管理
    • 企业信息查询
    • 分页查询员工
    • 新增员工
    • 删除员工
  • 印章管理
    • 分页查询个人印章列表
    • 分页查询企业印章列表
    • 查询个人印章详情
    • 查询企业印章详情
    • 获取印章静默签授权链接
  • 回调通知
    • 回调接入文档
    • 接口测试
    • 获取回调信息
    • 回调成功确认
    • 回调成功确认(新)
  • 开放接口
    • 企业四要素校验
    • 企业三要素校验
    • 身份证OCR识别
    • 营业执照OCR识别
    • 身份二要素校验
    • 银行卡二要素
    • 银行卡三要素
    • 银行卡四要素
    • 个人二要素诉讼信息
    • 个人运营商三要素
    • 企业工商四要素
  1. 本地文件上传

上传合同文件

POST
/api/contractFileUpload
V1.0.0V1.1.0V1.5.0
合同文件支持pdf、doc、docx、jpg、jpeg、bmp、png格式,大小不超过10M。对应content-type见下表
类型格式Content-Type
图片BMPimage/bmp
图片PNGimage/png
图片JPGimage/jpeg
图片JPEGimage/jpeg
wordDOCapplication/msword
wordDOCXapplication/vnd.openxmlformats-officedocument.wordprocessingml.document
PDFPDFapplication/pdf

请求参数

Query 参数
filename
string 
可选
文件名称,需带文件后缀(如:【租房合同.doc】)且与Content-Type对应类型一致。
在合同预览、下载、存证时展示的文件名。未填则系统随机生成
示例值:
租房合同.pdf
Header 参数
Content-Type
string 
必需
文件格式严格按照后缀选择,value值见说明
示例值:
application/pdf
Body 参数application/octet-stream
已上传文件

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'api.pre-qiandun365.com/api/contractFileUpload?filename=租房合同.pdf' \
--header 'Content-Type: application/pdf' \
--data-binary '@/Users/xbliao/Desktop/租房合同_A3.docx'

返回响应

🟢200成功
application/json
Body
code
string 
必需
msg
string 
必需
result
object  | null 
必需
fileCode
string 
文件Code
必需
文件唯一编码(发起时用这个)
filename
string 
文件名
必需
文件名,如果上传时未传‘filename’参数则系统随机生成
fileUrl
string 
文件地址
已废弃
fileViewUrl
string 
文件预览地址
必需
文件预览地址,有访问时效(预览时用这个)
fileType
string 
文件类型
必需
文件类型(pdf:PDF, word:Word, image:图片, audio:音频, video:视频, package:压缩包)
success
boolean 
必需
示例
{
  "code": "200",
  "msg": "成功",
  "result": {
    "fileCode": "FC_20230414105522daGzUlQganifJBP",
    "filename": "R-C.pdf",
    "fileUrl": "independent-signature-pri-dev:contract/pdf/2023/4/14/20230414105522tvuiKJfyYBOUMoxJFstv.pdf",
    "fileViewUrl": "https://independent-signature-pri-dev.devqd.work/contract/pdf/2023/4/14/20230414105522tvuiKJfyYBOUMoxJFstv.pdf?Expires=1681444524&OSSAccessKeyId=LTAI4FmuFfVmpcEJ8Dv3jZY5&Signature=T0VOfirhhbz%2BaEt6RBP39phvU%2Fc%3D",
    "fileType": "pdf"
  },
  "success": true
}
修改于 2025-01-17 07:59:13
上一页
查询企业授权信息
下一页
上传合同附件
Built with