电子合同API开发文档 v6

快速签章

接口地址:https://api.1dq.com/v6/QuickSign/create.json

请求方式:POST

参数位置:body

权限控制:支持

接口版本: v6.0

在线工具:API在线调试接口

接口描述:
1、此接口用于快速签章
2、1次请求可以添加同一主体的多个印章;
----如文件需要张三和李四2个人签订,需要调用2次接口;
----如文件需要张三在文件每一页签章并签骑缝章,调用1次接口即可;
3、数据与其他接口内容不互通,签署成功的文件无法在一定签APP或系统内看到;

postman json示范

请求参数

除去下列参数中,需要在header中添加公共参数,详见公共请求参数

参数名 是否必填 长度 类型 默认值 描述 示范
base64_file - STRING -
文件base64后的内容,支持pdf、doc、docx文件、如含有特殊字体请使用pdf文件
xxx
signed_data - STRING -
签章信息 ,数组格式, 参考下方signed_data
async_data - STRING -
选填项,异步通知的数据,原路返回,只有异步签署才生效
async_url - STRING -
选填项,异步通知的url,只有异步签署才生效
base64_file_suffix - STRING -
默认为空即可,原始的文件格式,如pdf、doc等,如果不能识别请填写
pdf
certification_level - STRING -
设定文档认证等级,一般情况下默认即可 , 可选值 LEVEL_FORM_FILLING_AND_ANNOTATIONS、LEVEL_FORM_FILLING、LEVEL_NO_CHANGES_ALLOWED、LEVEL_NONE
company_certification - OBJECT -
企业签署信息参考下方 company_certification,如果传递会忽略personal_certification参数
pagination_data - ARRAY -
骑缝章签章信息,数组格式, 参考下方pagination_data
pdf_password - STRING -
pdf文件的密码
personal_certification - OBJECT -
个人签署信息参考下方 personal_certification
signed_model - ARRAY -
默认同步接口,如需异步请传递async
signed_type - STRING default
签署类型,default默认签署模式,hidden无签章签署
default
timestamp_server_id - INT -
时间戳证书颁发机构,默认为1,不使用请输入-1 ,其他请于客服联系

请求示范

 POST https://api.1dq.com/v6/QuickSign/create.json
 {
    "async_data": "",
    "async_url": "",
    "base64_file": "xxx",
    "base64_file_suffix": "pdf",
    "certification_level": "",
    "company_certification": "",
    "pagination_data": "",
    "pdf_password": "",
    "personal_certification": "",
    "signed_data": "",
    "signed_model": "",
    "signed_type": "default",
    "timestamp_server_id": ""
}

返回结果

参数名 是否必填 长度 类型 默认值 描述 示范
code 1-10 long 业务状态码 200
msg 2-64 string 结果描述 请求成功
data - 结果集 -

----base64_file

- STRING 签署成功的PDF文件,base64格式,请自行保存

----file_temp_url

- STRING 签署成功的PDF文件,url可直接访问,有效期15分钟

成功示范

{
    "code": 200,
    "msg": "success",
    "data": {
        "base64_file": "xxxxx",
        "file_temp_url": "可直接访问"
    },
    "requestId": "e86dde00-7aec-11ee-9a9d-0242ac110003"
}

失败示范

{
    "code": 404,
    "msg": "base64_file为必填项",
    "data": [],
    "requestId": "ca3065d2-7ae9-11ee-ac0e-0242ac110003"
}

状态码

状态码 说明 备注
200 success -

其他备注

暂无

附件一 接口示范代码