# ID-Comparison

**Repository Path**: suguangnet/ID-Comparison

## Basic Information

- **Project Name**: ID-Comparison
- **Description**: 一个基于Python Flask的身份证号码比对Web应用，通过阿里云市场实名认证API验证身份证与姓名是否匹配。

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-19
- **Last Updated**: 2026-01-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 身份证号码比对系统

一个基于Python Flask的身份证号码比对Web应用，通过阿里云市场实名认证API验证身份证与姓名是否匹配。

## 功能特性

- 身份证号码格式验证（支持15位和18位）
- 中文姓名格式验证
- 通过实名认证API验证身份证与姓名匹配性
- 身份证信息解析（出生日期、性别等）
- 响应式用户界面
- 完整的前后端交互

## 技术栈

- Python 3.x
- Flask Web框架
- HTML5 + CSS3 + JavaScript
- Requests库用于API调用

## 目录结构

```
身份证比对/
├── app.py              # 主应用文件
├── config.py           # 配置文件
├── requirements.txt    # 依赖包列表
├── static/             # 静态资源
│   ├── style.css       # 样式文件
│   └── script.js       # 前端脚本
├── templates/          # 模板文件
│   └── index.html      # 主页模板
└── utils/              # 工具模块
    └── id_validator.py # 身份证验证工具
```

## 快速开始

1. 安装依赖：
   ```bash
   pip install -r requirements.txt
   ```

2. 配置API信息：
   在`config.py`中确认API密钥信息：
   ```python
   APP_CODE = '995d64edfb414b699ba5e27720d03bAB'    # 您的AppCode
   ```

3. 启动应用：
   ```bash
   python app.py
   ```

4. 打开浏览器访问：`http://localhost:5001`

## API接口说明

应用使用以下API接口进行身份证实名认证：
- 接口地址：`https://idenauthen.market.alicloudapi.com/idenAuthentication`
- 请求方法：POST
- 请求头：`Authorization: APPCODE {您的AppCode}`
- 请求参数：`idNo`（身份证号码）、`name`（姓名）

## 软件界面
![软件界面](软件界面.png)

## 注意事项

1. 请确保API密钥信息正确无误
2. 检查网络连接是否正常
3. API调用可能产生费用，请注意用量
4. 生产环境部署时请关闭DEBUG模式
5. 您的账户目前剩余用量：951/2100

## 错误处理

- API请求超时：提示"API请求超时，请稍后重试"
- 网络连接错误：提示"无法连接到验证服务，请检查网络连接"
- API授权失败：提示"API授权失败，请检查AppCode是否正确"
- 用量超限：提示"API访问被拒绝，可能是因为用量超限或配额用完"
- 请求过于频繁：提示"请求过于频繁，请稍后再试"

## 安全说明

- 身份证和姓名信息仅用于验证目的
- 所有敏感信息均通过HTTPS传输
- 遵循数据保护法规，不存储用户隐私信息

## 📞 技术支持

- **开发服务商**: 速光网络软件开发
- **官网**: suguang.cc
- **抖音号**: dubaishun12

---