验证用户身份证是否可用
检查用户身份证号是否已被注册。
接口地址:POST /verify/verify_is_user_id_available
请求头
| 参数名 | 必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 固定值:application/json |
请求参数
| 参数名 | 类型 | 必填 | 格式 | 说明 |
|---|---|---|---|---|
| user_id | string | 是 | 18位字符串 | 用户身份证号 |
请求示例
{
"user_id": "110***********1234"
}
响应参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | int | 是 | HTTP 状态码 |
| info | string | 是 | 用户身份证号可用性信息 |
| result | bool | 是 | 用户身份证号是否已注册 |
成功响应示例(已注册)
{
"status": 200,
"info": "用户身份证已注册",
"result": true
}
成功响应示例(未注册)
{
"status": 200,
"info": "用户身份证未注册",
"result": false
}
错误响应示例
接口未开放
{
"status": 403,
"info": "服务器未开放此接口",
"result": false
}
身份证号不合法
{
"status": 200,
"info": "用户身份证号不合法",
"result": false
}
提示
建议在用户注册前先调用此接口验证身份证号是否可用,可以提前告知用户,减少不必要的注册流程,提升用户体验。
警告
身份证号不合法时 result 返回 false,但仍返回 HTTP 200 状态码,请根据 info 字段判断具体原因。