身份证二要素核验 API 文档

注意事项： 使用本接口前需在原平台购买“身份证二要素核验”服务，并配置API Key和域名白名单。首次查询会调用第三方接口，结果将被永久缓存，后续相同身份证查询不扣费。

接口地址

POST https://api.mcve.top/API.php?action=idcard_verify

请求头

参数	必填	说明
X-API-Key	是	您的API Key
Content-Type	是	application/json

请求参数

字段	类型	必填	说明
name	string	是	姓名（UTF-8）
idcard	string	是	18位身份证号码

请求示例

{
    "name": "张三",
    "idcard": "110101199001011234"
}

成功响应

{
    "code": 0,
    "msg": "success",
    "data": {
        "res": "1",                // 核验结果：1-一致 2-不一致
        "description": "一致",
        "name": "张*",              // 脱敏姓名
        "idcard": "110101********1234",
        "sex": "男",
        "birthday": "1990-01-01",
        "address": "北京市东城区",
        "from_cache": false         // 是否来自缓存
    }
}

错误响应示例

{
    "code": 403,
    "msg": "未购买身份证核验服务，请先到商城购买"
}

错误码说明

code	说明
0	成功
400	参数缺失
401	API Key无效
403	未授权（域名/未购买）
429	请求频繁
500	服务器错误
502	第三方API错误

缓存机制

系统使用数据库缓存核验结果，键名为姓名+身份证号的组合。首次查询时调用第三方接口并存储结果；后续相同身份证查询直接从缓存返回（from_cache: true），不消耗第三方调用次数。缓存永久有效，如需强制刷新可联系管理员。