云岭API开放平台
首页 / API 文档 / 身份证校验解析

身份证校验解析

校验二代身份证号合法性(GB11643 校验位),并解析出生日期、性别、籍贯代码。仅做格式校验,不留存数据。

免费接口 需 API Key20 QPS最后更新 2026-11-23
接口信息

身份证校验解析 v1.0

校验二代身份证号合法性(GB11643 校验位),并解析出生日期、性别、籍贯代码。仅做格式校验,不留存数据。

接口地址https://api.ynshw.com.cn/api.php?action=IdCard&id=53250119900101001X
请求方式GET,POST
返回格式JSON
QPS 限制20
计费免费
鉴权说明在请求中携带 key 参数(或请求头 X-API-Key / Authorization: Bearer)。生产环境建议启用签名:将参数按名排序拼接为 secret&ts&nonce&k=v&... 后取 MD5,随 sign/ts/nonce 一起传入。

请求示例

https://api.ynshw.com.cn/api.php?action=IdCard&id=53250119900101001X
请求参数

请求参数

参数名类型必填说明
idstring是18 位身份证号
keystring是API Key,控制台获取
sign/ts/noncestring否签名三元组,启用后防重放(5 分钟有效)
返回参数

返回参数

参数名类型说明
codeint状态码,200 为成功
msgstring提示信息
validbool是否合法
birthdaystring出生日期
genderstring男|女
area_codestring行政区划代码

返回示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "valid": true,
        "birthday": "1990-01-01",
        "gender": "男",
        "area_code": "532501"
    }
}
在线测试

在线测试

需要 API Key请先 登录 并在控制台复制你的 Key,填入下方即可真实发起调用。
// 点击「发送请求」查看返回结果
示例代码

多语言示例

错误码

响应状态码

code说明
200成功
201参数错误
202鉴权失败(Key 无效/签名错误/已过期)
203次数或余额不足
204接口不存在
205接口停用
206请求方式不允许
207请求限流(超出 QPS)
208IP 不在白名单
209内部错误
210需实名认证