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参数不存在|||