Endpoint API

Endpoint di produzione per l'analisi del sangue. Consuma 1 credito per richiesta.

Parametri della richiesta

Esempio cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze" \
  -F "username=TUO_NOME_UTENTE" \
  -F "password=TUA_PASSWORD" \
  -F "language=it" \
  -F "file=@esame_sangue.pdf"

Esempio Python

import requests

def analizza_esame_sangue(percorso_file: str, nome_utente: str, password: str, lingua: str = "it"):
    """
    Analizza un file di esame del sangue con l'API Kantesti.

    Args:
        percorso_file: Percorso al PDF o immagine dell'esame del sangue
        nome_utente: Nome utente API
        password: Password API
        lingua: Codice lingua risposta (default: it)

    Returns:
        dict: Risposta API con i risultati dell'analisi
    """
    url = "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze"

    with open(percorso_file, "rb") as f:
        files = {"file": (percorso_file, f, "application/pdf")}
        dati = {
            "username": nome_utente,
            "password": password,
            "language": lingua
        }

        risposta = requests.post(url, files=files, data=dati, timeout=120)
        risposta.raise_for_status()
        return risposta.json()

# Esempio di utilizzo
if __name__ == "__main__":
    risultato = analizza_esame_sangue(
        percorso_file="esame_sangue.pdf",
        nome_utente="tuo_nome_utente",
        password="tua_password",
        lingua="it"
    )
    print(f"Stato: {risultato['status']}")
    print(f"Parametri trovati: {len(risultato['data']['parameters'])}")

Riferimento campi di risposta

Livello radice

Oggetto data.metadata

Elemento array data.parameters

Elemento array data.interpretation

Esempio di risposta completa

{
  "status": "success",
  "data": {
    "metadata": {
      "patient_name": "Anna Müller",
      "lab_name": "MedLab Diagnostics International",
      "lab_city": "Roma",
      "lab_country": "Italia",
      "lab_date": "2025-12-15",
      "results_date": "2025-12-16",
      "patient_age": "38",
      "patient_sex": "female"
    },
    "parameters": [
      {
        "short_name": "WBC",
        "long_name": "Conta dei globuli bianchi",
        "category": "Emocromo completo",
        "result": "6.8",
        "unit": "10^9/L",
        "evaluation": "normal",
        "range_min": "4.0",
        "range_max": "11.0",
        "short_description": "Misura il numero totale di globuli bianchi.",
        "long_description": "I globuli bianchi (leucociti) sono componenti essenziali del sistema immunitario..."
      },
      {
        "short_name": "RBC",
        "long_name": "Conta dei globuli rossi",
        "category": "Emocromo completo",
        "result": "4.52",
        "unit": "10^12/L",
        "evaluation": "normal",
        "range_min": "3.8",
        "range_max": "5.8",
        "short_description": "Misura il numero totale di globuli rossi.",
        "long_description": "I globuli rossi (eritrociti) trasportano l'ossigeno dai polmoni ai tessuti corporei..."
      },
      {
        "short_name": "HGB",
        "long_name": "Emoglobina",
        "category": "Emocromo completo",
        "result": "13.2",
        "unit": "g/dL",
        "evaluation": "normal",
        "range_min": "11.5",
        "range_max": "16.0",
        "short_description": "Proteina nei globuli rossi che trasporta l'ossigeno.",
        "long_description": "L'emoglobina è la proteina contenente ferro nei globuli rossi responsabile del trasporto dell'ossigeno..."
      },
      {
        "short_name": "GLU",
        "long_name": "Glicemia a digiuno",
        "category": "Pannello metabolico",
        "result": "102",
        "unit": "mg/dL",
        "evaluation": "borderline_high",
        "range_min": "70",
        "range_max": "140",
        "short_description": "Misura il livello di zucchero nel sangue a digiuno.",
        "long_description": "La glicemia a digiuno è un indicatore chiave di come il corpo metabolizza lo zucchero..."
      },
      {
        "short_name": "TC",
        "long_name": "Colesterolo totale",
        "category": "Profilo lipidico",
        "result": "218",
        "unit": "mg/dL",
        "evaluation": "borderline_high",
        "range_min": "0",
        "range_max": "300",
        "short_description": "Misura il colesterolo totale nel sangue.",
        "long_description": "Il colesterolo totale è la somma del colesterolo HDL, LDL e VLDL..."
      },
      {
        "short_name": "LDL",
        "long_name": "Colesterolo LDL",
        "category": "Profilo lipidico",
        "result": "142",
        "unit": "mg/dL",
        "evaluation": "high",
        "range_min": "0",
        "range_max": "200",
        "short_description": "Misura il livello di colesterolo 'cattivo'.",
        "long_description": "Il colesterolo LDL può accumularsi nelle pareti delle arterie..."
      }
    ],
    "interpretation": [
      {
        "title": "Valutazione generale della salute",
        "shortcode": "overall_health_assessment",
        "subsections": [
          {
            "subtitle": "Panoramica completa",
            "items": [
              {"item": "La paziente presenta parametri ematologici generalmente sani con tutti i valori dell'emocromo nella norma."},
              {"item": "Il profilo lipidico mostra aree che richiedono attenzione, in particolare i livelli di colesterolo LDL."}
            ]
          }
        ]
      },
      {
        "title": "Raccomandazioni",
        "shortcode": "recommendations",
        "subsections": [
          {
            "subtitle": "Modifiche dello stile di vita",
            "items": [
              {"item": "Aumentare l'attività fisica aerobica ad almeno 150 minuti a settimana."},
              {"item": "Adottare una dieta di tipo mediterraneo ricca di verdure, frutta e grassi sani."}
            ]
          }
        ]
      }
    ]
  },
  "api_version": "v11",
  "timestamp": "2025-12-16T14:32:18Z"
}

Analizza le tendenze dei parametri degli esami del sangue su più date di test per identificare pattern e fornire informazioni sulla salute.

Parametri di richiesta

Oggetto analysis_options

Struttura Array blood_tests

*È richiesto lab_date o results_date per ogni esame del sangue.

Struttura blood_tests[].parameters

Esempio cURL

curl -X POST https://app.aibloodtestinterpret.com/api/v1/analytics/trends/analyze \
  -H "Content-Type: application/json" \
  -d '{
    "username": "il_tuo_username",
    "password": "la_tua_password",
    "language": "it",
    "analysis_type": "comprehensive",
    "analysis_options": {
      "include_predictions": true,
      "include_statistics": true,
      "include_charts": true
    },
    "blood_tests": [
      {
        "lab_date": "2024-01-15",
        "parameters": [
          {"short_name": "GLU", "long_name": "Glucosio", "result": 105, "unit": "mg/dL"},
          {"short_name": "HbA1c", "long_name": "Emoglobina Glicata", "result": 6.2, "unit": "%"},
          {"short_name": "CHOL", "long_name": "Colesterolo Totale", "result": 220, "unit": "mg/dL"},
          {"short_name": "LDL", "long_name": "Colesterolo LDL", "result": 145, "unit": "mg/dL"},
          {"short_name": "HDL", "long_name": "Colesterolo HDL", "result": 48, "unit": "mg/dL"}
        ]
      },
      {
        "lab_date": "2024-05-10",
        "parameters": [
          {"short_name": "GLU", "long_name": "Glucosio", "result": 98, "unit": "mg/dL"},
          {"short_name": "HbA1c", "long_name": "Emoglobina Glicata", "result": 5.9, "unit": "%"},
          {"short_name": "CHOL", "long_name": "Colesterolo Totale", "result": 205, "unit": "mg/dL"},
          {"short_name": "LDL", "long_name": "Colesterolo LDL", "result": 130, "unit": "mg/dL"},
          {"short_name": "HDL", "long_name": "Colesterolo HDL", "result": 52, "unit": "mg/dL"}
        ]
      },
      {
        "lab_date": "2024-08-22",
        "parameters": [
          {"short_name": "GLU", "long_name": "Glucosio", "result": 92, "unit": "mg/dL"},
          {"short_name": "HbA1c", "long_name": "Emoglobina Glicata", "result": 5.6, "unit": "%"},
          {"short_name": "CHOL", "long_name": "Colesterolo Totale", "result": 195, "unit": "mg/dL"},
          {"short_name": "LDL", "long_name": "Colesterolo LDL", "result": 118, "unit": "mg/dL"},
          {"short_name": "HDL", "long_name": "Colesterolo HDL", "result": 55, "unit": "mg/dL"}
        ]
      },
      {
        "lab_date": "2024-12-18",
        "parameters": [
          {"short_name": "GLU", "long_name": "Glucosio", "result": 88, "unit": "mg/dL"},
          {"short_name": "HbA1c", "long_name": "Emoglobina Glicata", "result": 5.4, "unit": "%"},
          {"short_name": "CHOL", "long_name": "Colesterolo Totale", "result": 185, "unit": "mg/dL"},
          {"short_name": "LDL", "long_name": "Colesterolo LDL", "result": 105, "unit": "mg/dL"},
          {"short_name": "HDL", "long_name": "Colesterolo HDL", "result": 58, "unit": "mg/dL"}
        ]
      }
    ]
  }'

Esempio Python

import requests
from typing import List, Dict

def analizza_tendenze(nome_utente: str, password: str, esami_sangue: List[Dict], lingua: str = "it") -> Dict:
    """Analizza le tendenze degli esami del sangue nel tempo."""
    url = "https://app.aibloodtestinterpret.com/api/v1/analytics/trends/analyze"
    payload = {
        "username": nome_utente,
        "password": password,
        "language": lingua,
        "analysis_type": "comprehensive",
        "blood_tests": esami_sangue
    }
    risposta = requests.post(url, json=payload, timeout=120)
    risposta.raise_for_status()
    return risposta.json()

# Esempio
esami = [
    {"lab_date": "2025-01-15", "parameters": [{"short_name": "HGB", "result": 12.5, "unit": "g/dL"}]},
    {"lab_date": "2025-06-15", "parameters": [{"short_name": "HGB", "result": 13.2, "unit": "g/dL"}]},
    {"lab_date": "2025-12-01", "parameters": [{"short_name": "HGB", "result": 14.1, "unit": "g/dL"}]}
]
risultato = analizza_tendenze("utente", "password", esami)

Riferimento campi di risposta

Struttura oggetto parameter_trends

Esempio di risposta

{
  "status": "success",
  "data": {
    "overall_trend": "in miglioramento",
    "parameter_trends": [
      {
        "parameter": "HGB",
        "long_name": "Emoglobina",
        "direction": "in aumento",
        "change_percent": 12.8,
        "interpretation": "I livelli di emoglobina mostrano un miglioramento costante."
      }
    ]
  }
}

Esempio Python

import requests
from typing import Dict, List, Optional

def ottieni_piano_nutrizione(
    nome_utente: str,
    password: str,
    paziente: Dict,
    esame_sangue: Dict,
    lingua: str = "it"
) -> Dict:
    """Ottiene raccomandazioni personalizzate di nutrizione e integratori."""
    url = "https://app.aibloodtestinterpret.com/api/v1/nutrition/diet-plan/analyze"
    payload = {
        "username": nome_utente,
        "password": password,
        "language": lingua,
        "patient": paziente,
        "blood_test": esame_sangue
    }
    risposta = requests.post(url, json=payload, timeout=120)
    risposta.raise_for_status()
    return risposta.json()

# Esempio
paziente = {"age": 45, "gender": "male", "weight": 82, "height": 178}
esame = {"lab_date": "2025-12-01", "parameters": [{"short_name": "VITD", "result": 18, "unit": "ng/mL"}]}
risultato = ottieni_piano_nutrizione("utente", "password", paziente, esame)

Schema dell'Oggetto Paziente

Descrizione dettagliata di tutti i campi disponibili per l'oggetto paziente:

Esempio di risposta

{
  "status": "success",
  "data": {
    "supplements": [
      {
        "name": "Vitamina D3",
        "dosage": "2000 UI al giorno",
        "reason": "Livelli ematici a 18 ng/mL indicano carenza (ottimale: 30-50 ng/mL)",
        "priority": "alta"
      }
    ],
    "dietary_recommendations": [
      {"category": "aumentare", "foods": ["pesce grasso", "verdure a foglia verde"]}
    ]
  }
}

Riferimento campi di risposta

Oggetto nutrition_plan.educational_insights

Elemento array blood_marker_education

Elemento array food_recommendations.power_foods

Elemento array supplement_recommendations

Esempio cURL completo

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/nutrition/diet-plan/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "tuo_nome_utente",
    "password": "tua_password",
    "language": "it",
    "patient": {
      "age": 45,
      "gender": "male",
      "weight": 82,
      "height": 178,
      "conditions": ["hypertension"],
      "allergies": ["shellfish"],
      "dietary_preferences": ["mediterranean"],
      "activity_level": "moderate",
      "liked_foods": ["fish", "vegetables", "olive oil"],
      "disliked_foods": ["liver"],
      "meal_frequency": 3,
      "budget": "moderate"
    },
    "blood_test": {
      "lab_date": "2025-12-01",
      "parameters": [
        {"short_name": "VITD", "result": 18, "unit": "ng/mL"},
        {"short_name": "CHOL", "result": 210, "unit": "mg/dL"},
        {"short_name": "LDL", "result": 140, "unit": "mg/dL"},
        {"short_name": "HDL", "result": 45, "unit": "mg/dL"},
        {"short_name": "FE", "result": 65, "unit": "µg/dL"}
      ]
    },
    "health_goals": ["lower_cholesterol", "increase_energy", "heart_health"]
  }'

Risposta completa

{
  "status": "success",
  "data": {
    "nutrition_plan": {
      "daily_calories": 2100,
      "macros": {
        "protein": {"grams": 105, "percentage": 20},
        "carbohydrates": {"grams": 236, "percentage": 45},
        "fats": {"grams": 82, "percentage": 35}
      },
      "educational_insights": {
        "blood_marker_education": [
          {
            "marker": "Vitamina D",
            "explanation": "La vitamina D è essenziale per la salute delle ossa, la funzione immunitaria e la regolazione dell'umore. Il tuo livello di 18 ng/mL indica una carenza che può influenzare l'assorbimento del calcio e la salute generale.",
            "normal_range": "30-50 ng/mL"
          },
          {
            "marker": "Colesterolo LDL",
            "explanation": "Il colesterolo LDL, spesso chiamato 'colesterolo cattivo', può accumularsi nelle pareti arteriose. Il tuo livello di 140 mg/dL è elevato e può aumentare il rischio cardiovascolare.",
            "normal_range": "< 100 mg/dL"
          }
        ],
        "nutrition_principles": [
          "Dai priorità agli acidi grassi omega-3 per la salute del cuore",
          "Aumenta le fibre solubili per ridurre il colesterolo LDL",
          "Includi alimenti ricchi di vitamina D e fonti di sole"
        ]
      }
    },
    "food_recommendations": {
      "power_foods": [
        {
          "food": "Salmone selvaggio",
          "nutrients": ["Omega-3", "Vitamina D", "Proteine"],
          "serving": "150g, 3 volte a settimana",
          "why": "Fonte eccellente di omega-3 e vitamina D naturale per la salute cardiaca e ossea"
        },
        {
          "food": "Avena integrale",
          "nutrients": ["Beta-glucano", "Fibre", "Magnesio"],
          "serving": "50g al giorno a colazione",
          "why": "Le fibre solubili dell'avena aiutano a ridurre l'assorbimento del colesterolo LDL"
        },
        {
          "food": "Olio extra vergine di oliva",
          "nutrients": ["Grassi monoinsaturi", "Polifenoli", "Vitamina E"],
          "serving": "2-3 cucchiai al giorno",
          "why": "I grassi sani mediterranei migliorano il profilo lipidico e proteggono il cuore"
        },
        {
          "food": "Spinaci",
          "nutrients": ["Ferro", "Folato", "Vitamina K"],
          "serving": "100g al giorno, crudi o cotti",
          "why": "Ricchi di ferro e antiossidanti per l'energia e la salute cardiovascolare"
        }
      ]
    },
    "supplement_recommendations": [
      {
        "supplement": "Vitamina D3",
        "dosage": "2000-4000 UI al giorno",
        "timing": "Con la colazione (pasto contenente grassi)",
        "duration": "3-6 mesi, poi ritestare i livelli ematici",
        "reason": "Il tuo livello di 18 ng/mL è sotto l'ottimale di 30-50 ng/mL"
      },
      {
        "supplement": "Omega-3 (EPA/DHA)",
        "dosage": "1000-2000mg EPA+DHA al giorno",
        "timing": "Con i pasti principali",
        "duration": "Continuativo per la salute cardiaca",
        "reason": "Aiuta a ridurre i trigliceridi e migliora il rapporto HDL/LDL"
      },
      {
        "supplement": "Coenzima Q10",
        "dosage": "100mg al giorno",
        "timing": "Con il pasto del mattino",
        "duration": "Minimo 3 mesi",
        "reason": "Supporta la salute cardiaca, particolarmente importante con l'ipertensione"
      }
    ]
  },
  "api_version": "v1",
  "timestamp": "2025-12-22T10:30:00Z"
}

Analizza 2-20 esami del sangue e fornisce un confronto dettagliato con approfondimenti narrativi generati dall'IA.

Parametri di richiesta

Struttura Array blood_tests

*È richiesto lab_date o results_date per ogni esame del sangue.

Esempio Python

import requests
from typing import Dict, List

def confronta_esami_sangue(
    nome_utente: str,
    password: str,
    esami: List[Dict],
    lingua: str = "it"
) -> Dict:
    """
    Confronta più esami del sangue con analisi narrativa basata sull'IA.

    Args:
        nome_utente: Nome utente API
        password: Password API
        esami: Lista di oggetti esami del sangue (2-20 test)
        lingua: Lingua della risposta

    Returns:
        dict: Risultati del confronto con approfondimenti narrativi IA
    """
    url = "https://app.aibloodtestinterpret.com/api/v1/bloodtest/comparison/analyze"

    if len(esami) < 2:
        raise ValueError("Minimo 2 esami del sangue richiesti")
    if len(esami) > 20:
        raise ValueError("Massimo 20 esami del sangue consentiti")

    payload = {
        "username": nome_utente,
        "password": password,
        "language": lingua,
        "blood_tests": esami
    }

    risposta = requests.post(url, json=payload, timeout=120)
    risposta.raise_for_status()
    return risposta.json()

# Esempio di utilizzo
if __name__ == "__main__":
    test = [
        {
            "lab_date": "2024-06-15",
            "parameters": [
                {"short_name": "HGB", "result": 12.2, "unit": "g/dL"},
                {"short_name": "CHOL", "result": 235, "unit": "mg/dL"},
                {"short_name": "LDL", "result": 155, "unit": "mg/dL"}
            ]
        },
        {
            "lab_date": "2024-12-15",
            "parameters": [
                {"short_name": "HGB", "result": 14.5, "unit": "g/dL"},
                {"short_name": "CHOL", "result": 185, "unit": "mg/dL"},
                {"short_name": "LDL", "result": 98, "unit": "mg/dL"}
            ]
        }
    ]

    risultato = confronta_esami_sangue("tuo_nome_utente", "tua_password", test)

    print(f"Tendenza generale: {risultato['data']['comparison_summary']['overall_trend']}")
    for param in risultato['data']['parameter_analysis']:
        print(f"{param['parameter_name']}: {param['trend_assessment']}")

Riferimento campi di risposta

Struttura oggetto parameter_analysis

Esempio di risposta

{
  "api_version": "1.0.0",
  "status": "success",
  "message": "Confronto esami del sangue completato con successo",
  "timestamp": "2025-12-22T01:12:43.057537Z",
  "data": {
    "comparison_id": "CMP-F4ACEE52",
    "tests_compared": 2,
    "date_range": {
      "earliest": "2024-06-15",
      "latest": "2024-12-15",
      "span_days": 183
    },
    "comparison_summary": {
      "overall_trend": "migliorato",
      "report1_date": "2024-06-15",
      "report2_date": "2024-12-15",
      "time_interval": "183 giorni tra i report",
      "key_findings": [
        "Livelli di emoglobina ed RBC normalizzati indicano risoluzione dell'anemia",
        "Glucosio e HbA1c migliorati nell'intervallo normale suggerendo miglior controllo glicemico",
        "Profilo lipidico migliorato con colesterolo totale, LDL, HDL e trigliceridi normalizzati"
      ]
    },
    "parameter_analysis": [
      {
        "parameter_name": "Emoglobina",
        "report1_value": "12.2 g/dL",
        "report2_value": "14.5 g/dL",
        "change_type": "increased",
        "change_magnitude": "significant",
        "clinical_significance": "Miglioramento da anemia a livelli normali di emoglobina",
        "trend_assessment": "positive"
      },
      {
        "parameter_name": "Colesterolo LDL",
        "report1_value": "155 mg/dL",
        "report2_value": "98 mg/dL",
        "change_type": "decreased",
        "change_magnitude": "significant",
        "clinical_significance": "LDL vicino all'intervallo ottimale, riduce il rischio di aterosclerosi",
        "trend_assessment": "positive"
      }
    ],
    "health_assessment": {
      "overall_health_trend": "migliorato",
      "areas_of_improvement": [
        "Correzione dell'anemia",
        "Controllo glicemico",
        "Normalizzazione del profilo lipidico"
      ],
      "areas_of_concern": [],
      "positive_developments": [
        "Risoluzione dell'anemia",
        "Glucosio e HbA1c normali",
        "Miglioramento del profilo di rischio cardiovascolare"
      ]
    },
    "recommendations": {
      "immediate_actions": [
        "Continuare l'integrazione attuale per ferro e vitamina D",
        "Mantenere il controllo glicemico e lipidico con dieta ed esercizio"
      ],
      "follow_up_tests": [
        "Ripetere CBC e studi sul ferro in 3 mesi",
        "Monitorare glucosio a digiuno e HbA1c trimestralmente"
      ],
      "lifestyle_modifications": [
        "Adottare una dieta sana per il cuore a basso contenuto di grassi saturi",
        "Aumentare l'attività fisica per mantenere la salute metabolica"
      ]
    }
  }
}

Restituisce le informazioni della piattaforma API. Nessuna autenticazione richiesta.

Endpoint di verifica dello stato per il monitoraggio. Nessuna autenticazione richiesta.

Verifica la tua quota API rimanente. Autenticazione richiesta.

Esempio cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/quota/check" \
  -H "Content-Type: application/json" \
  -d '{"username": "TUO_NOME_UTENTE", "password": "TUA_PASSWORD"}'

Genera un rapporto completo di valutazione dei rischi di salute familiare alimentato dall'IA.

Parametri richiesta (JSON Body)

Esempio cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/family-health/analyze" \
  -H "Content-Type: application/json" \
  -d '{"username":"UTENTE","password":"PASSWORD","patient_data":{"name":"Giulia Rossi","age":42,"gender":"female"},"family_members":[{"relation":"father","age":70,"conditions":["hypertension"]}],"language":"it"}'

Esempio Python

import requests
url = "https://app.aibloodtestinterpret.com/api/v1/family-health/analyze"
payload = {"username":"UTENTE","password":"PASSWORD","patient_data":{"name":"Giulia Rossi","age":42,"gender":"female"},"family_members":[{"relation":"father","age":70,"conditions":["hypertension"]}],"language":"it"}
response = requests.post(url, json=payload, timeout=120)
print(response.json())

Esempio di risposta

{"status":"success","data":{"report_data":{"report_title":"Rapporto di Valutazione dei Rischi di Salute Familiare","hereditary_risk_analysis":{"high_risk":[{"condition":"Malattia cardiovascolare","risk_score":75}]},"genetic_screening_recommendations":["Test genetico BRCA1/BRCA2"]}},"timestamp":"2026-03-23T10:30:00Z","api_version":"1.0.0"}

Codici errore Family Health API

Estrae tutto il contenuto testuale dai documenti caricati utilizzando la tecnologia ICR di Kantesti.

Parametri Richiesta

Esempio cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/icr/v1/extract" \
  -F "username=TUO_NOME_UTENTE" \
  -F "password=TUA_PASSWORD" \
  -F "language=it" \
  -F "[email protected]"

Esempio Python

import requests

def icr_extract(file_path: str, username: str, password: str, language: str = "it"):
    """
    Estrai testo da un documento con l'API ICR Kantesti.
    79% più veloce e preciso dell'OCR tradizionale.
    """
    url = "https://app.aibloodtestinterpret.com/api/icr/v1/extract"

    with open(file_path, "rb") as f:
        files = {"file": (file_path, f)}
        data = {"username": username, "password": password, "language": language}
        response = requests.post(url, files=files, data=data, timeout=120)
        response.raise_for_status()
        return response.json()

# Esempio di utilizzo
result = icr_extract("referto_medico.pdf", "nome_utente", "password", "it")
print(f"Tipo documento: {result['data']['document_type']}")
print(f"Pagine: {result['data']['page_count']}")

Esempio di Risposta

{
  "status": "success",
  "data": {
    "document_type": "blood_test_report",
    "page_count": 1,
    "pages": [{"page_number": 1, "content": {"raw_text": "Ospedale Universitario di Colonia - Esame del Sangue...", "sections": [{"type": "header", "content": "Esame del Sangue"}], "tables": [{"headers": ["Test", "Risultato", "Unità", "Range di Riferimento"], "rows": [["Glucosio", "92", "mg/dL", "74 - 100"], ["ALT", "22", "U/L", "< 35"]]}]}}],
    "metadata": {"detected_language": "it", "confidence": "high"},
    "icr_metadata": {"engine": "kantesti-icr", "version": "1.0.0", "images_processed": 1, "timestamp": "2026-02-14T10:30:00Z"}
  },
  "credit_cost": 0.5,
  "api_version": "icr-v1"
}