Saltar al contenido
Constaia

FastAPI

Valida documentos con IA en FastAPI

UploadFile y httpx.AsyncClient; mismo patrón para verificar webhooks.

Instalación

pip install fastapi httpx python-multipart

El patrón seguro

El navegador o la app nunca ven tu clave secreta. El fichero va a tu servidor, tu servidor llama a Constaia y devuelve el veredicto.

Guía completa
main.py
import json
import os

import httpx
from fastapi import FastAPI, UploadFile

app = FastAPI()
API = "https://api.constaia.com/v1/analyze"


@app.post("/api/verify")
async def verify(file: UploadFile):
    options = {"expect": "es_dni", "checks": {"not_expired": True}}
    async with httpx.AsyncClient(timeout=60) as client:
        res = await client.post(
            API,
            headers={"Authorization": f"Bearer {os.environ['CONSTAIA_API_KEY']}"},
            files={"file": (file.filename, await file.read(), file.content_type)},
            data={"options": json.dumps(options)},
        )
    res.raise_for_status()
    return {"status": res.json()["verdict"]["status"]}

Una llamada. Una respuesta que puedes usar.

  1. 01

    Envía el documento y lo que esperas

    Foto, captura o PDF. Indica el tipo esperado y las reglas: vigente, de menos de 6 meses, a nombre de esta persona.

  2. 02

    Leemos, clasificamos y comprobamos

    OCR europeo, clasificación con IA y validadores deterministas: letra del NIF, MRZ, IBAN, fechas y cuadres.

  3. 03

    Recibe el veredicto y borra el fichero

    valid, invalid o review con motivos en tu idioma. Por defecto el fichero se borra al terminar.

Y para que conste…

Crea tu cuenta, copia la clave de test y valida tu primer documento en cinco minutos.