1.11 快捷签约
简要描述:
- 企业如果有自由职业者身份证照片,银行卡信息,可以选择使用该接口快捷完成签约,但是只有少数服务商开放,非标准接口。
注意事项:
- 请尽量将身份证照片压缩至1M以内提交,否则可能会因为照片体积过大造成接口超时或者签署失败。
- 为了提高接口响应速度,平台在对提交的信息做了基础校验后,便会返回签约记录的id。同时后台会异步去跟第三方电子合同厂商交互完成电子合同签订过程,该交互过程一般在5-10秒,所以真正的签约结果以异步通知的为准,在没有收到异步通知之前,系统签约状态任然为签约中。
请求头参数:
Authorization: Bearer [accessToken]
请求URL:
- /contracts/employees/sign
请求方式:
- POST
请求参数说明
字段名称 | 类型 | 是否必须 | 说明 |
---|---|---|---|
字段名称 | 类型 | 是否必须 | 说明 |
employeeNo | string | 否 | 企业端用户编号 |
providerId | string | 是 | 服务商Id |
projectId | string | 否 | 项目id,如果不传,系统自动匹配 |
papersNo | string | 是 | 身份证号码 |
name | string | 是 | 姓名 |
phone | string | 是 | 手机号码 |
bankCardNo | string | 否 | 银行卡号 |
bankName | string | 否 | 开户行,当设置了bankCardNo时,该值必填,如果不知道开户,可以填姓名。 |
notifyUrl | string | 否 | 接收该签约结果的后端回调url。当该url没有传值时,系统会使用后台开发者配置中的回调链接。注意:该url必须为可以直接访问的http链接,例如:https://www.baidu.com |
idCardFrontBase64 | string | 是 | 身份证人像面照片文件的base64字符串,请base64字符串前面增加data描述信息,例如data:image/jpeg;base64,/9j/4... |
idCardBackBase64 | string | 是 | 身份证国徽面照片文件的base64字符串,请base64字符串前面增加data描述信息,例如data:image/jpeg;base64,/9j/4... |
返回示例
成功示例:
{
"employeeId": "123456",
"employeeNo": "xxxxxxx"
}
失败示例:
{
"error": "BadRequest",
"message": "银行卡格式不正确"
}