接口地址: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 | - |
暂无