电子合同API开发文档 v5

签署合同-h5页面签署

通过h5网页签署合同，也可以通过纯api接口完成，
备注：
1、如果该用户已经签署合同，那么该链接会变成预览合同
2、可重复调用，有效期20分钟
3、如果合同是企业签署，请传递企业的easy_id ， 如果是个人签署，传递个人的easy_id
4、个人必须完成实名认证之后才可以签署，企业必须企业和经办人都完成认证才可以签署合同
5、微信用户可直接跳转到小程序签署； wx.navigateToMiniProgram({ appId: 'wx86be3e47df5e5e65', path: '返回的url，不包含域名和#号' })

Header 请求参数：

参数名 是否必填 长度 类型 默认值 描述 内容
appId 是 32 string - 贵司的appId，可在后台可以查看
signature 是 64 string - 签名效验，请参考签名生成
version 是 6 long - 版本号
token 否 60-256 string - 用户的token，可通过用户登录接口获取Token
clientType 否 2-10 string API 用户客户端类型，如WEB、H5、APP、API等
clientId 否 32 string - 用户客户端ID，请传递真实的客户端ID

body 请求参数：

参数名 是否必填 长度 类型 默认值 描述 内容
easy_id 是 18 STRING
签署用户的easy_id，如果有多个用户需要签署，请循环调用本接口，如果传递number参数，该参数可不传递
open_id 是 - STRING
签署用户的open_id
words_id 是 - STRING
合同id
btn_text 否 - STRING 确定签署合同
按钮文字
channel 否 - STRING
通道名称 可选项 api/autoApi
color 否 - STRING
按钮颜色
display_date 否 - INT 1
是否显示日期选择，1显示 -1不显示，默认显示
display_handwritten_signature 否 - INT 1
是否显示手写签名，1显示 -1不显示，默认显示
display_personal_tpl 否 - INT
隐藏个人模板印章，1显示，-1隐藏
display_place 否 - INT 1
是否显示骑缝章，1显示 -1不显示，默认显示
display_public_header 否 - STRING
操作条，如果channel传递api默认不显示，传递autoApi默认显示
display_success_footer 否 - INT
签署成功，再次预览文档下方按钮，1显示，-1隐藏，新对接的客户已取消该参数，统一为不显示
display_success_header_help 否 - INT
隐藏顶部帮助图标，1显示，-1隐藏
display_success_page 否 - STRING
是否显示签署成功页面，1显示，-1直接跳转到redirect_url， 默认显示成功签署的页面
display_system_seal 否 - INT 1
是否显示系统印章选择，1显示 -1不显示，默认显示
number 否 - STRING
通过手机号/邮箱 获取免登陆链接
org_id 否 - STRING
签署机构的org_id ,如果存在
redirect_url 否 - STRING
签署成功后返回的地址（网址需要能正常访问），如果设置了不显示签署成功页面，当您提供的网址无法正常访问时，页面可能会一直等待