Saltar para o conteúdo
Constaia

FastAPI

Valide documentos com IA em FastAPI

UploadFile e httpx.AsyncClient; o mesmo padrão para verificar webhooks.

Instalação

pip install fastapi httpx python-multipart

O padrão seguro

O navegador ou a app nunca veem a sua chave secreta. O ficheiro vai para o seu servidor, o seu servidor chama a Constaia e devolve o veredicto.

Guia completo
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"]}

Uma chamada. Uma resposta que pode usar.

  1. 01

    Envie o documento e o que espera

    Fotografia, captura de ecrã ou PDF. Indique o tipo esperado e as regras: válido, com menos de 6 meses, em nome desta pessoa.

  2. 02

    Lemos, classificamos e verificamos

    OCR europeu, classificação com IA e validadores determinísticos: letra do NIF, MRZ, IBAN, datas e totais.

  3. 03

    Receba o veredicto e apague o ficheiro

    valid, invalid ou review com motivos no seu idioma. Por omissão, o ficheiro é apagado quando a análise termina.

E para que conste…

Crie a sua conta, copie a chave de teste e valide o seu primeiro documento em cinco minutos.