3.身份证签约接口(弃用)
>d 请正确选择贵司的签约方式,如不知晓具体签约方式,可联系商务支持;
## 时序图
![image.png](https://cos.easydoc.net/74722269/files/kxo3vsr1.png)
## 1.身份证资料上传接口
#### 接口地址:/open/api/v1/sign/certification/upload
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|name|签约姓名|String|是|需要签约人的姓名|
|idCard|签约身份证号码|String|是|需要签约人的身份证号码|
|mobile|手机号|String|是||
|frontIdCard|身份证正面照片URL|String|是||
|backIdCard|身份证反面照片URL|String|是||
|hatlessPhoto|自拍照片URL|String|是||
#### 接口响应参数data字段解密后的参数说明:
|参数名称| 参数含义| 数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|token| token|String |是||
|protocol|协议链接|String| 是|用于阅读即将要签署的协议|
|protocolList|协议链接|String| 是|用于阅读即将要签署的协议,多个协议按逗号拼接|
#### 异常参数说明:
|code| status|解析信息| 解决方案| 备注|
|-|-|-|-|-|
|DATA_NOT_EXIST|1|XXX参数不存在|||
|KEYS_ERROR|1006|三要素(姓名,身份证,手机号)校验错误|确认上传的姓名、身份证、手机号信息是否正确||
|PARAM_ILLEGAL|3|手机号码已经被绑定|||
|USER_SIGN_AGE_OUT_LIMIT|1037|系统检测到您的年龄不符合平台规则,暂时无法签约,感谢您的理解|||
|ID_CARD_BACK_ERROR|9089|请重新上传身份证(人像面)|重新上传身份证人像面|
|ID_CARD_FRONT_ERROR|9090|请重新上传身份证(国徽面)|重新上传身份证国徽面|
|ID_CARD_FACE_MATCH_ERROR|9091|人脸照片与本人信息不符,请重新上传|||
|ID_CARD_FRONT_MATCH_ERROR|9092|签约身份证号与识别的身份证号不匹配|确认上传的身份证号码与客户本人信息是否正确||
|UNABLE_TO_SIGN|10025|暂不能签约,请联系客服||
|USER_SIGN|1029|您已经签约过了,请重新登入刷新||
## 2.签署接口
#### 接口地址:/open/api/v1/sign/face/sign
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|token|token信息|String|是||
>d 注意:
> 1. 签约的token有一定时效性,时间间隔是2个小时,超过时长会返回相应的错误提示;
> 2. 如果超过时效,需要重新调用 1.身份证资料上传接口 重新获取token信息
#### 接口响应参数data字段解密后的参数说明:
|参数名称| 参数含义| 数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|idCard|签约身份证号码|String|是|
|protocol|协议链接|String| 是|已签约的协议的URL地址|
|protocolList|协议链接|String| 是|用于阅读即将要签署的协议,多个协议按逗号拼接|
#### 异常参数说明:
|code| status|解析信息| 解决方案| 备注|
|-|-|-|-|-|
|TOKEN_INVALID|9045|token失效请重新获取token|||
|DATA_ERROR|9049|数据异常,请联系管理员||
|IS_EMPLOYED_NOT_SIGN|8031|签约失败,已注册过个体工商户!|||
|DATA_NOT_EXIST|1|XXX参数不存在|||