Need help with id-validator.py?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

jxlwqq
274 Stars 66 Forks MIT License 102 Commits 4 Opened issues

Description

中华人民共和国居民身份证、中华人民共和国港澳居民居住证以及中华人民共和国台湾居民居住证号码验证工具(Python 版)

Services available

!
?

Need anything else?

Contributors list

# 21,899
PHP
Compose...
compose...
Markdow...
90 commits
# 153,260
Dart
Objecti...
lunar
solar
4 commits

中华人民共和国居民身份证\ 、\ 中华人民共和国港澳居民居住证\ 以及\ 中华人民共和国台湾居民居住证\ 号码验证工具(Python 版)支持 15 位与 18 位号码。仅支持 Python 3。

  • Go 版本 
    __
  • PHP 版本 
    __
  • Ruby 版本 
    __
  • JavaScript 版本 
    __

.. image:: https://github.com/jxlwqq/id-validator.py/actions/workflows/testing.yml/badge.svg :target: https://github.com/jxlwqq/id-validator.py/actions/workflows/testing.yml

安装

.. code:: bash

pip install id-validator

使用

440308199901101512
610104620927690
示例大陆居民身份证均为随机生成的假数据,如撞车,请联系删除。
810000199408230021
830000199201300022
示例港澳台居民居住证为北京市公安局公布的居住证样式号码。

验证身份证号合法性 ~~~~~~~~~~~~~~~~~~

验证身份证号是否合法,合法返回

True
\ ,不合法返回
False
\ :

.. code:: python

from id_validator import validator

validator.isvalid('440308199901101512') # 大陆居民身份证 18 位 validator.isvalid('610104620927690') # 大陆居民身份证 15 位 validator.isvalid('810000199408230021') # 港澳居民居住证 18 位 validator.isvalid('830000199201300022') # 台湾居民居住证 18 位

获取身份证号信息 ~~~~~~~~~~~~~~~~

当身份证号合法时,返回分析信息(地区、出生日期、星座、生肖、性别、校验位),不合法返回

False
\ :

.. code:: python

from id_validator import validator

validator.getinfo('440308199901101512') # 18 位 validator.getinfo('610104620927690') # 15 位

返回信息格式如下:

.. code:: python

{ 'addresscode' : '440308', # 地址码 'abandoned' : 0, # 地址码是否废弃,1 为废弃的,0 为正在使用的 'address' : '广东省深圳市盐田区', # 地址 'addresstree' : ['广东省', '深圳市', '盐田区'] # 省市区三级列表 'age' : 21, # 年龄,当前的年份减去出生年份,例:2020-1999=21 'birthdaycode' : '1999-01-10', # 出生日期 'constellation' : '摩羯座', # 星座 'chinesezodiac' : '卯兔', # 生肖 'sex' : 1, # 性别,1 为男性,0 为女性 'length' : 18, # 号码长度 'check_bit' : '2' # 校验码 }

..

注:判断地址码是否废弃的依据是\

中华人民共和国行政区划代码历史数据集 
\ ,本数据集的采集源来自:\
中华人民共和国民政部 
\ ,每年更新一次。本数据集采用 csv 格式存储,方便大家进行数据分析或者开发其他语言的版本。

生成可通过校验的假数据 ~~~~~~~~~~~~~~~~~~~~~~

伪造符合校验的身份证:

.. code:: python

from id_validator import validator

validator.fakeid() # 18 位 validator.fakeid(False) # 15 位 validator.fakeid(True, '上海市', '2000', 1) # 生成出生于 2000 年上海市的男性居民身份证 validator.fakeid(True, '南山区', '1999', 0) # 生成出生于 1999 年广东省深圳市南山区的女性居民身份证 validator.fakeid(True, '江苏省', '200001', 1) # 生成出生于 2000 年 1 月江苏省的男性居民身份证 validator.fakeid(True, '厦门市', '199701', 0) # 生成出生于 1997 年 1 月福建省厦门市的女性居民身份证 validator.fakeid(True, '台湾省', '20131010', 0) # 生成出生于 2013 年 10 月 10 日台湾省的女性居民居住证 validator.fakeid(True, '香港特别行政区', '19970701', 0) # 生成出生于 1997 年 7 月 1 日香港特别行政区的女性居民居住证

身份证升级 ~~~~~~~~~~~~~~~~~~~~~~

15 位号码升级为 18 位:

.. code:: python

from id_validator import validator

validator.upgrade_id('610104620927690')

参考资料

  • 中华人民共和国公民身份号码 
    __
  • 中华人民共和国民政部:行政区划代码 
    __
  • 中华人民共和国行政区划代码历史数据集 
    __
  • 国务院办公厅关于印发《港澳台居民居住证申领发放办法》的通知 
    __
  • 港澳台居民居住证 
    __

Change Log

  • 1.0.10: get_info 返回值添加省市区三级列表
  • 1.0.13: get_info 返回值添加年龄信息

License

MIT 
__

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.