获取授权自动签页面
简要描述
获取授权自动签页面
请求地址
/v4/api/fdd/operateBeforeAuthSignHeader
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Token | 是 | string | 应用令牌 |
请求参数
| 参数名 | 必选 | 类型 | 层级 | 说明 | 示例 |
|---|---|---|---|---|---|
| transactionId | 是 | string | 1 | 交易号 | FDDXXXXXXXXXXX |
| authType | 是 | string | 1 | 授权类型 1:授权自动签（目前只能填1） | 1 |
| contractId | 是 | string | 1 | 合同编号 | HT202605260001 |
| customerId | 是 | string | 1 | 客户编号 | 3E4B4CXXXX |
| signatureId | 否 | string | 1 | 印章编号 | SEALXXXXXXXXXX |
| notifyEmail | 否 | string | 1 | 通知邮箱 显示在填写邮箱的页面上，用于接收自动签的签署信息 | xx@xx.com |
| signVerifyWay | 否 | string | 1 | 签署意愿方式 1：短信验证；3：刷脸验证 10：短信验证和刷脸验证二选一 当接口中该参数传入有值时，以接口传入的值为准，否则则取运营后台配置。若实名认证时无填写手机号，则无法使用短信验证 | 1 |
| returnUrl | 否 | string | 1 | 页面跳转URL（签署结果同步通知） 当签章完成后，在签章页面停留数秒后浏览器会自动跳转到此URL，内容由接入平台自行展示；若需跳入小程序path格式：pages/index/index 需要配合open_environment且不支持跳转tabBar页面 使用return_url最大长度为500 | https://xxx/return |
| notifyUrl | 是 | string | 1 | 签署结果（授权成功通知）异步通知URL | https://xxx/notify |
| openEnvironment | 否 | string | 1 | 打开环境 0、跳转h5；（默认） 1、支持在客户小程序path中跳转，path的写法如 /page/page1；2、跳转法大大公证处小程序 4、由中间页跳转法大大公证处小程序 | 0 |
| saveHandSignature | 否 | string | 1 | 是否保存手写签名印章作为默认章 0：默认不保存 1：保存仅对个人类型且签章类型为手写时生效 | 0 |
| mobileSignType | 否 | string | 1 | 签章类型 0：全部；1：标准；2：手写 当接口中该参数传入有值时，以接口传入的配置为准，否则则取运营后台配置 | 1 |
| pcHandSignature | 否 | string | 1 | 支持pc手写印章 1：pc端支持手写印章（需mobile_sign_type签章类型为2时支持） | 0 |
| resultType | 否 | string | 1 | 刷脸成功后是否显示结果页面 1、直接跳转到同步地址，2、需要用户点击完成验证按钮后才跳转到同步地址。默认为2 | 2 |
| writingTrack | 否 | string | 1 | 是否开启手写轨迹 0：关闭 1：开启 手写轨迹仅支持汉字 当接口中该参数传入有值时，以接口传入的配置为准，否则则取运营后台配置 | 0 |
| verifyWayFlag | 否 | string | 1 | 签署意愿方式选择人脸识别时，人脸识别失败后自动调整为短信 默认为0 0：不换；1：切换 | 0 |
| signatureShowTime | 否 | string | 1 | 时间戳显示方式 不传默认为1 1：以后台配置为准，如果存在部分签署显示、部分签署不显示的场景，需要配置 显示时间戳，以及时间戳显示样式 2：不显示时间戳 | 1 |
入参示例
json
{
"transactionId": "FDDXXXXXXXXXXX",
"authType": "1",
"contractId": "HT202605260001",
"customerId": "3E4B4CXXXX",
"signatureId": "SEALXXXXXXXXXX",
"notifyUrl": "https://xxx/notify"
}返回参数
| 参数名 | 类型 | 层级 | 说明 |
|---|---|---|---|
| code | int | 1 | 状态码 |
| msg | string | 1 | 请求结果 |
| total | int | 1 | 返回总条数 |
| requestId | string | 1 | 请求编号 |
| data | object | 1 | 返回数据 |
| url | string | 2 | 签约地址 |
成功返回示例
json
{
"code": 200,
"msg": "业务处理成功",
"data": {
"url": "https://xxx/authSign"
},
"total": null,
"requestId": "ef1945c"
}失败返回示例
json
{
"code": 500,
"msg": "业务处理失败",
"data": null,
"total": null,
"requestId": "661df7a1"
}