电子合同API开发文档 v5

签署合同-自定义签署

接口地址:https://api.1dq.com/v5/Contracts/signed.json

请求方式:POST

参数位置:body

权限控制:支持

接口版本: v5.0

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

接口描述:
签署合同,用于后台签署,无需同用户交互
1、坐标查询请登录https://web.1dq.com/#/words 找到对应的合同,放置印章到想盖章的位置,在点击右侧文件信息,最底部可以看到x,y坐标
2、意愿认证默认开启,如需关闭需联系商务关闭

请求参数

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

参数名 是否必填 长度 类型 默认值 描述 示范
easy_id 18 STRING -
签署用户的easy_id,如果有多个用户需要签署,请循环调用本接口
175592531139104768
open_id 36 STRING -
签署用户的open_id
91eba5aa-ad70-11ea-ac9a-0242ac320a0c
signed_data - JSON -
签章信息 JSON格式,每次最多支持10个印章
查看示范
[ { "seal_id": "必填-印章id", "page": "第几页如2", "x": "必填-需要盖章的x坐标位置", "y": "必填-需要盖章的y坐标位置" }, { "seal_id": "abf447a8-ad71-11ea-b95e-0242ac320a0c", "page": "1", "x": "200", "y": "200" }, { "seal_id": "abf447a8-ad71-11ea-b95e-0242ac320a0c", "page": "6", "x": "200", "y": "200" } ]
words_id 36 STRING -
合同id
2c6084c0-ad71-11ea-9664-0242ac320a0c
certification_code - STRING -
选填项,意愿认证code, 通过意愿认证接口获得
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9
certification_type - STRING -
选填项,意愿认证类型
mobile
cross_page_data - JSON -
骑缝章信息
查看示范
[ { "seal_id": "abf447a8-ad71-11ea-b95e-0242ac320a0c", "y": "100" }, { "seal_id": "必填-印章id", "y": "必填-需要盖章的y坐标位置" } ]
org_id 36 STRING -
签署机构的org_id ,如果存在
abf447a8-ad71-11ea-b95e-0242ac320a0c
page_width - STRING -
选填项,页面宽度
800

请求示范

 POST https://api.1dq.com/v5/Contracts/signed.json
 {
    "certification_code": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9",
    "certification_type": "mobile",
    "cross_page_data": "[ { \"seal_id\": \"abf447a8-ad71-11ea-b95e-0242ac320a0c\", \"y\": \"100\" },{\r\n        \"seal_id\": \"必填-印章id\",\r\n        \"y\": \"必填-需要盖章的y坐标位置\"\r\n    } ]",
    "easy_id": "175592531139104768",
    "page_width": "800",
    "signed_data": "[ {\r\n        \"seal_id\": \"必填-印章id\",\r\n\t\"page\": \"第几页如2\",\r\n\t\"x\": \"必填-需要盖章的x坐标位置\",\r\n        \"y\": \"必填-需要盖章的y坐标位置\"\r\n    }\r\n,{ \"seal_id\": \"abf447a8-ad71-11ea-b95e-0242ac320a0c\", \"page\": \"1\", \"x\": \"200\", \"y\": \"200\" }, { \"seal_id\": \"abf447a8-ad71-11ea-b95e-0242ac320a0c\", \"page\": \"6\", \"x\": \"200\", \"y\": \"200\" }]",
    "words_id": "2c6084c0-ad71-11ea-9664-0242ac320a0c"
}

返回结果

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

成功示范

{
    "code": 200,
    "msg": "签署成功",
    "data": []
}

失败示范

{
    "code": 404,
    "msg": "页面信息不正确",
    "data": []
}

状态码

状态码 说明 备注
200 success -

其他备注

暂无

附件一 接口示范代码