ID-validator

Проверка номера удостоверения личности в Китае.

Возможности

• Проверка номера китайского удостоверения личности.
• Получение информации о номере удостоверения личности.
• Преобразование 15-значного номера в 18-значный.
• Создание поддельного номера, который пройдёт проверку.

Требования

• Go >= 1.14.

Установка

$ go get -u github.com/guanguans/id-validator

Использование

Это лишь краткое введение, для получения подробной информации обратитесь к GoDoc.

Давайте начнём с простого примера:

package main

import (
    idvalidator "github.com/guanguans/id-validator"
    "gopkg.in/ffmt.v1"
)

func main() {
    // Проверка законности номера удостоверения личности
    ffmt.P(idvalidator.IsValid("500154199301135886", true))  // Строгая проверка 18-значных номеров удостоверений личности граждан материкового Китая
    ffmt.P(idvalidator.IsValid("500154199301135886", false)) // Нестрогая проверка 18-значных номеров удостоверений личности граждан материкового Китая
    ffmt.P(idvalidator.IsValid("11010119900307803X", false)) // 18-значный номер удостоверения личности гражданина материкового Китая, оканчивающийся на X
    ffmt.P(idvalidator.IsValid("610104620927690", false))    // 15-значный номер удостоверения личности гражданина материкового Китая
    ffmt.P(idvalidator.IsValid("810000199408230021", false)) // 18-значный номер вида на жительство Гонконга
    ffmt.P(idvalidator.IsValid("830000199201300022", false)) // 18-значный номер вида на жительство Тайваня

    // Получение информации о номере удостоверения личности
    ffmt.P(idvalidator.GetInfo("500154199301135886", true))  // Получение полной информации о номере удостоверения личности при строгой проверке
    ffmt.P(idvalidator.GetInfo("500154199301135886", false)) // Получение частичной информации о номере удостоверения личности при нестрогой проверке
}

Тестирование

$ make test

Журнал изменений

Для получения дополнительной информации об изменениях см. CHANGELOG.md.

Вклад

Подробности см. в CONTRIBUTING.md.

Уязвимости безопасности

Пожалуйста, ознакомьтесь с нашей политикой безопасности, чтобы узнать, как сообщать об уязвимостях безопасности.

Авторы

• guanguans
• Все участники.

Связанные проекты

• jxlwqq/id-validator, автор jxlwqq.
• jxlwqq/id-validator.py, автор jxlwqq.
• mc-zone/IDValidator, автор mc-zone.
• renyijiu/id_validator, автор renyijiu.

Справочные материалы

• Китайское удостоверение личности.
• Административный код Министерства по гражданским делам Китайской Народной Республики.
• Исторические данные административного кода Китайской Народной Республики. Государственный совет по изданию мер по применению и выдаче разрешений на проживание для жителей Гонконга, Макао и Тайваня](http://www.gov.cn/zhengce/content/2018-08/19/content_5314865.htm)
• Разрешение на проживание для жителей Гонконга, Макао и Тайваня (https://zh.wikipedia.org/wiki/港澳台居民居住证)

License

The MIT License (MIT). Пожалуйста, обратитесь к License File для получения дополнительной информации.