契约锁 API

合同管理-用文件添加合同文档

POST

/v2/document/addbyfile

使用本地文件添加合同文档，仅草稿状态的合同可添加合同文档。

请求参数

Header 参数

Content-Type

string

必需

示例值:

multipart/form-data;charset=UTF-8

x-qys-open-accesstoken

string

可选

默认值:

x-qys-open-timestamp

string

可选

默认值:

x-qys-open-nonce

string

可选

默认值:

x-qys-open-signature

string

可选

默认值:

Body 参数multipart/form-data

contractId

string

必需

合同ID，合同ID与业务ID二选一，不能同时为空

bizId

string

可选

业务ID，合同ID与业务ID二选一，不能同时为空

tenantName

string

可选

子公司名称，若使用业务ID添加合同文件，且合同是以子公司身份创建的，则需要传递该值，用于确定合同主体

title

string

名称

必需

file

必需

合同文件 ,文件大小：<=30MB

fileSuffix

string

必需

文件类型（文件后缀）：doc，docx，pdf，jpeg，png，jpg，gif，tiff，html，htm，xls，xlsx

示例值:

doc,docx，pdf，jpeg，png，jpg，gif，tiff，html，htm，xls，xlsx

documentSort

integer

文档指定排序

可选

示例值:

1~2147483647

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.qiyuesuo.com/v2/document/addbyfile' \
--header 'x-qys-open-accesstoken: {{x-qys-open-accesstoken}}' \
--header 'x-qys-open-timestamp: {{x-qys-open-timestamp}}' \
--header 'x-qys-open-nonce: {{x-qys-open-nonce}}' \
--header 'x-qys-open-signature: {{x-qys-open-signature}}' \
--header 'Content-Type: multipart/form-data;charset=UTF-8' \
--form 'contractId=""' \
--form 'title=""' \
--form 'file=@""' \
--form 'fileSuffix="doc,docx，pdf，jpeg，png，jpg，gif，tiff，html，htm，xls，xlsx"'

返回响应

🟢200成功

application/json

Body

code

integer

响应码

必需

message

string

响应消息

必需

示例

{
  "result": {
    "documentId": "3053227770336247942"
  },
  "code": 0,
  "message": "SUCCESS"
}

合同管理-创建合同草稿

合同管理-多文件添加合同文档