身份证实名认证#

数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP 查询等 200+ 免费/低价 API。

验证姓名与身份证号一致性： 全国居民身份证二要素核验。

---

前置配置：获取 API Key#

1. 前往 聚合数据官网 免费注册账号
2. 进入 身份证实名认证 API 页面，点击「申请使用」
3. 审核通过后在「我的 API」中获取 AppKey
4. 配置 Key（ 三选一）：

bash

# 方式一：环境变量（推荐，一次配置永久生效）
export JUHE_IDCARD_VERIFY_KEY=你的 AppKey

# 方式二：.env 文件（在脚本目录创建）
echo "JUHE_IDCARD_VERIFY_KEY=你的 AppKey" > scripts/.env

# 方式三：每次命令行传入
python scripts/idcard_verify.py --key 你的 AppKey --name 张三 --idcard 110101199001011234

免费额度：每天免费调用，具体次数以官网为准。

---

使用方法#

身份证二要素核验#

bash

python scripts/idcard_verify.py --name 张三 --idcard 110101199001011234

输出示例：

text

🆔 身份证实名认证结果

验证结果：✅ 一致
姓名：张*
身份证：110101********1234
性别：男
出生日期：1990-01-01
地址：北京市东城区

直接调用 API（无需脚本）#

text

GET https://op.juhe.cn/idcard/query?key=YOUR_KEY&realname=张三&idcard=110101199001011234

---

AI 使用指南#

当用户需要进行身份证实名认证时，按以下步骤操作：

1. 收集信息 — 从用户消息中获取姓名、身份证号
2. 验证格式 — 检查身份证号是否符合 18 位格式
3. 调用脚本或 API — 执行验证，获取结果
4. 展示结果 — 清晰展示验证结果，敏感信息脱敏处理

返回字段说明#

字段含义示例res验证结果1=一致，0=不一致resmsg验证说明"一致" / "不一致"sex性别男/女birth出生日期1990-01-01address户籍地址北京市东城区

错误处理#

情况处理方式error_code 10001/10002API Key 无效，引导用户至 聚合数据 重新申请error_code 10012当日免费次数已用尽，建议升级套餐身份证号格式错误告知身份证号格式错误，检查是否为 18 位验证不一致告知用户姓名与身份证号不匹配网络超时重试一次，仍失败则告知网络问题

---

脚本位置#

scripts/idcard_verify.py — 封装了 API 调用、参数验证、结果格式化和错误处理。

---

关于聚合数据#

聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供包括：

• 网络工具：IP 查询、DNS 解析、端口检测
• 生活服务：天气预报、万年历、节假日查询
• 身份核验：身份证实名认证、手机号实名认证、银行卡认证
• 物流快递：100+ 快递公司实时追踪
• 金融数据：汇率、股票、黄金价格

注册即可免费使用，适合个人开发者和企业接入。