Italy Codice Fiscale API

Genera e valida il Codice Fiscale italiano. Nessuna dipendenza esterna, nessun limite da provider upstream. Include ricerca comuni con codice Belfiore e decodifica completa dei dati personali incorporati.

原始信息汇总

Italy Codice Fiscale API 数据集概述

基本信息

• 数据集名称: Italy Codice Fiscale API
• 类别: Location
• 提供者: Emilio
• 订阅者数量: 1

功能描述

该API用于生成、验证和解码意大利税码（Codice Fiscale），无需外部依赖。

• 生成: 根据姓名、出生日期、性别和出生地生成有效的意大利税码。
• 验证与解码: 验证任何16位意大利税码，并解码其中嵌入的数据（出生日期、性别和出生地）。
• 数据查询: 按名称搜索7,900多个意大利城市并获取其Belfiore代码（生成税码所需）。

数据源

• 算法: 意大利政府官方规范（DPR 605/1970）。
• 城市数据库: ISTAT + Agenzia delle Entrate（7,904个城市）。

技术特点

• 零运营成本: 无上游API调用，不会因第三方服务导致超时。
• 高性能: 城市数据集在启动时加载到内存中，查询速度低于毫秒级。
• 完全自包含: 即使外部网络完全中断也能正常工作。

API端点与使用流程

该API包含3个端点，典型使用流程为：搜索城市 → 生成税码 → 验证税码。

1. 搜索城市

• 端点: GET /municipalities?q=Roma

• 请求示例: GET /municipalities?q=Roma

• 响应示例: json [ { "name": "Roma", "province": "RM", "belfiore_code": "H501", "active": true } ]

• 说明: 获取belfiore_code字段用于后续步骤。也适用于外国查询（例如：/municipalities?q=Albania返回代码Z401）。

2. 生成税码

• 端点: POST /generate

• 请求示例: json { "first_name": "Mario", "last_name": "Rossi", "birth_date": "1985-08-01", "gender": "M", "birth_municipality_code": "H501" }

• 响应示例: json { "fiscal_code": "RSSMRA85M01H501Q", "valid": true }

• 参数要求:

  • birth_date: 必须为YYYY-MM-DD格式。
  • gender: 仅接受M或F。
  • birth_municipality_code: 从/municipalities端点获取的Belfiore代码。

3. 验证与解码

• 端点: GET /validate?fiscal_code=RSSMRA85M01H501Q

• 请求示例: GET /validate?fiscal_code=RSSMRA85M01H501Q

• 响应示例（有效税码）: json { "valid": true, "fiscal_code": "RSSMRA85M01H501Q", "birth_date": "1985-08-01", "gender": "M", "birth_municipality_code": "H501", "birth_municipality_name": "Roma" }

• 响应示例（无效税码）: json { "valid": false, "fiscal_code": "RSSMRA85M01H501X", "error": "Invalid fiscal code" }

• 说明: 可以验证任何意大利税码，不仅限于此API生成的税码。

订阅计划

• BASIC: $0.00 / 月
• PRO: $9.99 / 月
• ULTRA: $29.99 / 月
• MEGA: $99.99 / 月