20211221-接口参数“签署日期”开启校验通知

涉及环境：正式环境
开启时间：2021年12月21日

背景说明：

【一步发起签署】、【添加平台方自动盖章签署区】、【添加签署方手动盖章签署区】、【添加签署方自动盖章签署区】接口中关于签署日期的两个配置参数：

signDateBeanType（页码是否添加签署日期的配置开关： 0-禁止 1-必须 2-不限制，默认0）

与signDateBean（签署日期信息：格式、页码、坐标），

目前接口逻辑对signDateBeanType参数的校验不是强校验，为了规范接口使用规则，计划对此参数规则进行修改。

修改后的逻辑：

如果不需要添加 【签署日期信息】，入参时请不要添加 signDateBean 和 signDateBeanType 参数。
signDateBeanType = 0 时，禁止添加签署日期，则不需要添加 signDateBean 参数；
signDateBeanType = 1 时，强制添加签署日期，则 signDateBean 参数为必传项；
signDateBeanType = 2 时，不限制是否添加签署日期，signDateBean 参数为非必传项。
注：当 autoExecute = true（自动签）时，signDateBeanType 不可以设置为2。

如果 signDateBeanType = 2，但不传 signDateBean 会报“参数错误: 自动签不支持自由签署日期”。
影响范围：

电子签名 SaaS API 标准版和非标版、钉签API版中的【一步发起签署】、【添加平台方自动盖章签署区】、【添加签署方手动盖章签署区】、【添加签署方自动盖章签署区】接口。
解决方法：

贵司应用系统中如有关于页面添加签署日期的判断逻辑，请自查当前逻辑并依据最新接口逻辑整改，以免接口更新后对贵司业务产生影响。

改动后如遇到问题，您可直接通过贵司所在的对接交流群反馈或通过下方二维码进入故障紧急上报值班群。