Consulta de CPF grátis para instituições de ensino: matrícula e rematrícula

curl -X GET https://api.cpfhub.io/cpf/12345678900 \
    -H "x-api-key: SUA_CHAVE_DE_API" \
    -H "Accept: application/json"

{
    "success": true,
    "data": {
    "cpf": "12345678900",
    "name": "Amanda Rodrigues Lima",
    "nameUpper": "AMANDA RODRIGUES LIMA",
    "gender": "F",
    "birthDate": "10/05/2005",
    "day": 10,
    "month": 5,
    "year": 2005
    }
}

import requests
from datetime import date

def validar_matricula_escolar(cpf_aluno: str, nome_aluno: str,
    cpf_responsavel: str, nome_responsavel: str) -> dict:
    headers = {
    'x-api-key': 'SUA_CHAVE_DE_API',
    'Accept': 'application/json'
    }

    resultados = {}

    # Validar aluno
    cpf_limpo = cpf_aluno.replace('.', '').replace('-', '')
    url = f'https://api.cpfhub.io/cpf/{cpf_limpo}'
    response = requests.get(url, headers=headers, timeout=10)
    resultado_aluno = response.json()

    if resultado_aluno.get('success'):
    dados_aluno = resultado_aluno['data']
    nome_confere = nome_aluno.upper().strip().split()[0] in dados_aluno['nameUpper']

    # Calcular idade
    hoje = date.today()
    idade = hoje.year - dados_aluno['year']
    if (hoje.month, hoje.day) < (dados_aluno['month'], dados_aluno['day']):
    idade -= 1

    resultados['aluno'] = {
    'cpf_valido': True,
    'nome_confere': nome_confere,
    'nome_oficial': dados_aluno['name'],
    'idade': idade,
    'data_nascimento': dados_aluno['birthDate']
    }
    else:
    resultados['aluno'] = {
    'cpf_valido': False,
    'mensagem': 'CPF do aluno nao encontrado'
    }

    # Validar responsavel
    import time
    time.sleep(2) # Respeitar rate limit

    cpf_resp_limpo = cpf_responsavel.replace('.', '').replace('-', '')
    url_resp = f'https://api.cpfhub.io/cpf/{cpf_resp_limpo}'
    response_resp = requests.get(url_resp, headers=headers, timeout=10)
    resultado_resp = response_resp.json()

    if resultado_resp.get('success'):
    dados_resp = resultado_resp['data']
    nome_resp_confere = nome_responsavel.upper().strip().split()[0] in dados_resp['nameUpper']

    resultados['responsavel'] = {
    'cpf_valido': True,
    'nome_confere': nome_resp_confere,
    'nome_oficial': dados_resp['name']
    }
    else:
    resultados['responsavel'] = {
    'cpf_valido': False,
    'mensagem': 'CPF do responsavel nao encontrado'
    }

    # Resultado geral
    tudo_ok = (resultados['aluno'].get('cpf_valido', False) and
    resultados['aluno'].get('nome_confere', False) and
    resultados['responsavel'].get('cpf_valido', False) and
    resultados['responsavel'].get('nome_confere', False))

    resultados['aprovado'] = tudo_ok
    resultados['mensagem'] = 'Matricula aprovada' if tudo_ok else 'Verificar divergencias'

    return resultados

resultado = validar_matricula_escolar(
    cpf_aluno='123.456.789-00',
    nome_aluno='Amanda Rodrigues Lima',
    cpf_responsavel='987.654.321-00',
    nome_responsavel='Roberto Lima Santos'
)
print(resultado)

async function validarRematricula(cpfAluno) {
    const cpfLimpo = cpfAluno.replace(/\D/g, '');

    if (cpfLimpo.length !== 11) {
    return { valido: false, mensagem: 'CPF invalido' };
    }

    const controller = new AbortController();
    const timeoutId = setTimeout(() => controller.abort(), 10000);

    try {
    const response = await fetch(
    `https://api.cpfhub.io/cpf/${cpfLimpo}`,
    {
    headers: {
    'x-api-key': 'SUA_CHAVE_DE_API',
    'Accept': 'application/json'
    },
    signal: controller.signal
    }
    );

    clearTimeout(timeoutId);
    const resultado = await response.json();

    if (!resultado.success) {
    return {
    valido: false,
    mensagem: 'CPF nao localizado. Verifique o numero informado.'
    };
    }

    return {
    valido: true,
    nome: resultado.data.name,
    dataNascimento: resultado.data.birthDate,
    genero: resultado.data.gender,
    mensagem: 'Dados confirmados. Prossiga com a rematricula.'
    };
    } catch (error) {
    clearTimeout(timeoutId);
    return {
    valido: true,
    mensagem: 'Servico de validacao indisponivel. Prossiga com os dados informados.'
    };
    }
}

def verificar_idade_serie(cpf: str, serie: str) -> dict:
    # Tabela simplificada de idade minima por serie
    idade_minima = {
    'infantil_4': 4,
    'infantil_5': 5,
    '1_ano': 6,
    '2_ano': 7,
    '6_ano': 11,
    '1_medio': 15
    }

    cpf_limpo = cpf.replace('.', '').replace('-', '')
    url = f'https://api.cpfhub.io/cpf/{cpf_limpo}'
    headers = {
    'x-api-key': 'SUA_CHAVE_DE_API',
    'Accept': 'application/json'
    }

    response = requests.get(url, headers=headers, timeout=10)
    resultado = response.json()

    if not resultado.get('success'):
    return {'verificado': False, 'mensagem': 'CPF nao encontrado'}

    dados = resultado['data']
    hoje = date.today()
    idade = hoje.year - dados['year']
    if (hoje.month, hoje.day) < (dados['month'], dados['day']):
    idade -= 1

    idade_min = idade_minima.get(serie, 0)
    adequado = idade >= idade_min

    return {
    'verificado': True,
    'nome': dados['name'],
    'idade': idade,
    'serie': serie,
    'idade_minima': idade_min,
    'adequado': adequado,
    'mensagem': 'Idade adequada para a serie' if adequado else f'Aluno com {idade} anos -- abaixo da idade minima ({idade_min} anos)'
    }