身份证号码解析

接口标识: idcard 价格: 0.005 元/次 VIP免费同步响应

接口介绍
接口文档
在线测试

接口简介

身份证号码解析接口输入18位身份证号码，按GB 11643-1999校验位规则验证号码合法性，并解析出户籍省份与城市、出生日期、周岁年龄、性别、生肖与星座，号码本身脱敏返回（保留前6位与后4位）。适合注册实名前置校验、表单自动填充与用户画像补全。

详细介绍

![身份证号码解析接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_idcard__1794166665_e8fc0a405849.png)

一串18位身份证号码，藏着户籍地、生日、性别三组关键信息。本接口纯离线解析：先过GB 11643-1999校验位验证，再拆出省市、出生日期、年龄、性别、生肖与星座，号码脱敏返回，注册表单与用户画像即接即用。

## 接口概述

身份证号码解析接口面向用户注册、实名认证前置检查、会员画像、表单自动填充等场景：传入一个18位身份证号码，接口在本地完成三步处理——格式与校验位验证（GB 11643-1999）、出生日期合法性检查、信息拆解，一次性返回户籍省份与城市、出生日期、周岁年龄、性别（按第17位奇偶判定）、生肖、星座共8项字段。全程纯离线计算，不调用任何外部服务，毫秒级返回；号码以脱敏形式回显（保留前6位与后4位），可安全写入日志与前台展示。需要注意：本接口验证的是号码本身的合法性，不联网核验持证人真实身份。

## 核心能力

1. **校验位验证**：按GB 11643-1999标准验证末位校验码，直接拦截输错与编造的号码。
2. **户籍地解析**：内置全国省市编码映射，提取号码前6位对应的户籍省份与城市。
3. **生日与年龄**：拆出出生日期（YYYY-MM-DD）并按当前日期实时计算周岁年龄。
4. **性别判定**：按第17位奇偶直接得出男/女，免去人工核对。
5. **画像扩展**：附带生肖与星座字段，营销与社区场景开箱即用。
6. **隐私脱敏**：号码脱敏返回，中间8位以*替代，满足展示与存储合规要求。

## 产品优势

- **接入简单**：POST请求、JSON返回，仅 idcard 一个业务参数。
- **毫秒级响应**：纯本地离线计算，无上游依赖与限流，支持高并发批量处理。
- **准确规范**：校验位与出生日期合法性双重验证，字段格式统一，直接落库无需清洗。
- **隐私合规**：脱敏回显设计，减少敏感信息暴露面。
- **降本增效**：替代前端自行编写解析与校验逻辑，口径统一、维护归零。

## 效果展示

一句话理解：它就像一位熟悉编码规则的「户籍内勤」——扫一眼号码，先辨真伪，再把藏在里面的籍贯、生日、性别一条条念给你听。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| idcard | 110101199001011237 | 18位身份证号码，也是这个接口唯一的业务参数 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 脱敏号码 | 110101********1237 | `idcard`，可直接回显给用户核对 |
| 户籍省份 | 北京 | `province` |
| 户籍城市 | 北京市 | `city` |
| 出生日期 | 1990-01-01 | `birthday` |
| 周岁年龄 | 36 | `age`，按调用当日实时计算 |
| 性别 | 男 | `gender`，按第17位奇偶判定 |
| 生肖/星座 | 马 / 摩羯座 | `zodiac` / `constellation` |

API请求示例：

```
POST /api/v1/idcard
idcard=110101199001011237
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "idcard": "110101********1237",
    "province": "北京",
    "city": "北京市",
    "birthday": "1990-01-01",
    "age": 36,
    "gender": "男",
    "zodiac": "马",
    "constellation": "摩羯座"
  }
}
```

号码通过校验位验证后即返回全部8项字段：`birthday`、`gender` 等可直接回填表单，用户无需重复填写；脱敏后的 `idcard` 可安全回显给用户核对。

## 应用场景

- **注册校验**：实名注册环节先行拦截格式错误与校验位不符的号码，减少无效认证请求
- **表单填充**：用户输入证件号后自动带出生日、性别、年龄，省去重复填写
- **用户画像**：补全地域、年龄段、星座生肖维度，支撑分群运营
- **风控初筛**：识别明显编造的证件号码，降低人工审核量
- **会员关怀**：按生日、生肖星座圈人，做生日礼遇与主题活动触达

## 应用案例

- **在线教育平台**：接入前学员信息靠手工录入，生日与地区字段缺失严重；接入后凭证件号自动补全画像字段，课程顾问的生日关怀触达率显著提升。
- **电商风控团队**：注册环节原先只做长度校验，编造号码大量流入；接入后校验位验证当场拦截假号，下游实名认证的失败量明显下降。

常见问题

Q：这个接口能解析出哪些信息？

A：从18位身份证号码中提取户籍省份与城市、出生日期、周岁年龄、性别、生肖、星座共8项字段，返回的号码本身已脱敏（保留前6位与后4位，中间8位以*替代）。

Q：接口能验证身份证的真伪吗？

A：不能。接口执行GB 11643-1999校验位验证与出生日期合法性检查，能识别输错、编造的号码，但不联网核验持证人身份；如需与权威信息比对的实名核验，请使用平台的身份证核验类接口。

Q：什么样的号码会被拒绝？

A：非18位或含非法字符的号码返回「idcard 格式无效，请输入18位身份证号码」；校验位不符返回「idcard 校验位无效，请核实身份证号码」；出生日期段非法（如13月）返回「idcard 中的出生日期无效」。以上均为参数错误（错误码40002）。

Q：港澳台开头的号码支持吗？

A：省份映射内置71（台湾）、81（香港）、82（澳门）前缀，符合18位格式且校验位正确即可解析；部分城市编码未收录时 city 返回「未知」，其余字段正常返回。

Q：返回的身份证号码是完整的吗？

A：不是。为保护隐私，idcard 字段返回脱敏结果：保留前6位（地区码）与后4位，中间8位（出生日期段）以*替代，其余解析字段完整返回，可安全用于展示与日志。

身份证解析证件号识别户籍地查询生日年龄提取校验位验证实名前置校验

接口地址： https://www.phpwc.cn/api/idcard

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`idcard`	string	必填	-	18位身份证号码

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`idcard`	string	脱敏后的身份证号（保留前 6 位与后 4 位，中间 8 位以 * 替代）
`province`	string	省份
`city`	string	城市
`birthday`	string	出生日期 YYYY-MM-DD
`age`	int	年龄（周岁）
`gender`	string	性别：男/女
`zodiac`	string	生肖
`constellation`	string	星座
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试