Integração entre FastAPI e consulta de CPF
O FastAPI pode atuar como camada segura entre o frontend e uma API de CPF. O backend verifica permissão, valida a entrada, envia X-API-KEY ao provedor e controla a resposta. A API CPF usa GET https://api.apicpf.dev/consulta?cpf=; a resposta documentada contém um objeto data.
Instale as dependências em seu ambiente: python -m pip install fastapi uvicorn requests. Configure APICPF_KEY apenas no servidor. Não use dados reais de terceiros como material de teste.
Exemplo de endpoint com requests
import os
import re
import requests
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
app = FastAPI()
class CpfEntrada(BaseModel):
cpf: str
@app.post("/consulta-cpf")
def consulta(payload: CpfEntrada):
# TODO: autenticação, autorização e limite de taxa local.
cpf = re.sub(r"\D", "", payload.cpf)
if len(cpf) != 11:
raise HTTPException(400, "CPF mal formatado")
key = os.getenv("APICPF_KEY")
if not key:
raise HTTPException(503, "Consulta indisponível")
try:
resp = requests.get(
"https://api.apicpf.dev/consulta",
params={"cpf": cpf},
headers={"X-API-KEY": key},
timeout=(3, 10),
)
resp.raise_for_status()
data = resp.json().get("data")
if not isinstance(data, dict):
raise ValueError("Resposta inesperada")
return {"nome": data.get("nome")}
except (requests.RequestException, ValueError):
raise HTTPException(502, "Falha na consulta")
Como o endpoint usa def em vez de async def, o FastAPI executa a função síncrona em worker apropriado. Se optar por chamada assíncrona, utilize cliente HTTP compatível como httpx.AsyncClient e defina timeout.
O que não está incluído no exemplo
Autenticação do seu usuário, permissão para consultar CPFs, limite de volume, verificação matemática e política de retenção são responsabilidades da sua aplicação. O código serve de ponto de partida e não constitui uma API pública segura por si só.
Tratamento de erros em produção
Monitore erro de entrada separadamente de falhas de provedor. Se a consulta upstream responder 401 ou 402, há causa administrativa para revisão; se responder 429, limite tentativas. Não repasse headers ou payloads internos ao frontend. Veja erros de API CPF.
Perguntas frequentes
FastAPI deve consultar CPF pelo frontend?
Não. O browser chama seu backend autenticado, que pode realizar a consulta sem revelar a chave.
Como testar sem gastar créditos?
Simule respostas por mocks em testes unitários e use o endpoint de validação matemática quando suficiente. Consulte testes de API CPF.
