中华人民共和国居民身份证、中华人民共和国港澳居民居住证以及中华人民共和国台湾居民居住证号码验证工具(Python 版)支持 15 位与 18 位号码。
pip install id-validator
440308199901101512
和610104620927690
示例大陆居民身份证均为随机生成的假数据,如撞车,请联系删除。810000199408230021
和830000199201300022
示例港澳台居民居住证为北京市公安局公布的居住证样式号码。
验证身份证号是否合法,合法返回 True
,不合法返回 False
:
from id_validator import validator validator.is_valid('440308199901101512') # 大陆居民身份证 18 位 validator.is_valid('610104620927690') # 大陆居民身份证 15 位 validator.is_valid('810000199408230021') # 港澳居民居住证 18 位 validator.is_valid('830000199201300022') # 台湾居民居住证 18 位
当身份证号合法时,返回分析信息(地区、出生日期、星座、生肖、性别、校验位),不合法返回 False
:
from id_validator import validator validator.get_info('440308199901101512') # 18 λ validator.get_info('610104620927690') # 15 λ
返回信息格式如下:
{ 'addressCode' : '440308', # 地址码 'abandoned' : 0, # 地址码是否废弃,1 为废弃的,0 为正在使用的 'address' : '广东省深圳市盐田区', # 地址 'birthdayCode' : '1999-01-10', # 出生日期 'constellation' : '水瓶座', # 星座 'chineseZodiac' : '卯兔', # 生肖 'sex' : 1, # 性别,1 为男性,0 为女性 'length' : 18, # 号码长度 'checkBit' : '2' # 校验码 }
注:判断地址码是否废弃的依据是中华人民共和国行政区划代码历史数据集,本数据集的采集源来自:中华人民共和国民政部,每年更新一次。本数据集采用 csv 格式存储,方便大家进行数据分析或者开发其他语言的版本。
伪造符合校验的身份证:
from id_validator import validator validator.fake_id() # 18 位 validator.fake_id(False) # 15 位 validator.fake_id(True, '上海市', '2000', 1) # 生成出生于 2000 年上海市的男性居民身份证 validator.fake_id(True, '南山区', '1999', 0) # 生成出生于 1999 年广东省深圳市南山区的女性居民身份证 validator.fake_id(True, '江苏省', '200001', 1) # 生成出生于 2000 年 1 月江苏省的男性居民身份证 validator.fake_id(True, '厦门市', '199701', 0) # 生成出生于 2000 年 1 月福建省厦门市的女性居民身份证 validator.fake_id(True, '台湾省', '20131010', 0) # 生成出生于 2013 年 10 月 10 日台湾省的女性居民居住证 validator.fake_id(True, '香港特别行政区', '19970701', 0) # 生成出生于 1997 年 7 月 1 日香港特别行政区的女性居民居住证
Todo List
- 增加对 Python2 的支持
- 增加单元测试和 CI