电子合同API开发文档 v5

手机认证-验证手机验证码

接口地址:https://api.1dq.com/v5/WillCertification/smsCheck.json

请求方式:POST

参数位置:body

权限控制:支持

接口版本: v5.0

在线工具:API在线调试接口

接口描述:
验证手机意愿验证码是否正确

请求参数

除去下列参数中,需要在header中添加公共参数,详见公共请求参数

参数名 是否必填 长度 类型 默认值 描述 示范
code - INT -
验证码,6位数字
954262
easy_id 18 STRING -
用户id
175592531139104768
open_id - STRING -
用户id
4c6a1d2c-ebfa-11ea-895b-0242ac110011
task_id - STRING -
任务id
212657d2-edfa-11ea-9161-0242ac110006

请求示范

 POST https://api.1dq.com/v5/WillCertification/smsCheck.json
 {
    "code": "954262",
    "easy_id": "175592531139104768",
    "task_id": "212657d2-edfa-11ea-9161-0242ac110006"
}

返回结果

参数名 是否必填 长度 类型 默认值 描述 示范
code 1-10 long 业务状态码 200
msg 2-64 string 结果描述 请求成功
data - 结果集 -

----certification_code

- STRING 意愿认证成功的code

----certification_type

- STRING 意愿认证类型

成功示范

{
    "code": 404,
    "msg": "验证码不能为空"
}

失败示范

{
    "code": 200,
    "msg": "验证通过",
    "data": {
        "certification_code": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJTSEVSTE9DSyBKSUFTSFVEQVRBLkNPTSIsImlhdCI6MTU5OTE0MTgwNywiZXhwIjoxNTk5MjI4MjA3LCJhdWQiOiJKSUFTSFVEQVRBIiwic3ViIjoiUFVCTElDVVNFUiIsImRhdGEiOnsidGFza19pZCI6IjJjNWM1N2ZjLWVkZWUtMTFlYS1iMzI3LTAyNDJhYzExMDAwNiIsInNjZW5lIjoic2lnbmVkIn19.snpl2JqWqbFc5b4wuOlbpzWhzWXpgJe24fxV2s_JKt0",
        "certification_type": "mobile"
    }
}

状态码

状态码 说明 备注
200 success -

其他备注

暂无

附件一 接口示范代码