验证姓名与身份证号是否匹配。每次调用消耗1次身份实名认证API调用次数。
请求参数
| 参数名 |
类型 |
是否必填 |
描述 |
| api_key |
string |
必填 |
用户API密钥 |
| name |
string |
必填 |
姓名（2-50个字符，支持中文、英文、空格、连字符） |
| idcard |
string |
必填 |
身份证号（18位） |
响应字段说明
| 字段名 |
类型 |
说明 |
| success |
boolean |
请求是否成功 |
| message |
string |
响应消息 |
| matched |
boolean |
姓名与身份证号是否匹配 |
| extra |
object |
补充信息（根据上游接口返回，可能包含：sex/gender性别、birthday/birth出生日期、address/location地址、age年龄、nation民族、province省份、city城市、district区县等） |
参数传递方式
参数可通过以下方式传递（优先级从高到低）：
1. JSON Body (Content-Type: application/json)
2. POST Form (Content-Type: application/x-www-form-urlencoded)
3. GET Query String
请求示例
// JSON 请求示例 (application/json)
{
"api_key": "your_api_key",
"name": "张三",
"idcard": "110101199001011234"
}
// POST 请求示例 (application/x-www-form-urlencoded)
api_key=your_api_key&name=张三&idcard=110101199001011234
// GET 请求示例
api/id_verification_api.php?api_key=your_api_key&name=张三&idcard=110101199001011234
响应示例
{
"success": true,
"message": "核验通过",
"matched": true,
"extra": {
"sex": "男",
"birthday": "19900101",
"address": "北京市东城区"
}
}
{
"success": true,
"message": "核验不通过，姓名与身份证号不匹配",
"matched": false,
"extra": {}
}
{
"success": false,
"message": "身份实名认证调用次数不足"
}