API Endpoints

Productie endpoint voor bloedtest analyse. Verbruikt 1 credit per verzoek.

Verzoekparameters

cURL Voorbeeld

curl -X POST "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze" \
  -F "username=UW_GEBRUIKERSNAAM" \
  -F "password=UW_WACHTWOORD" \
  -F "language=nl" \
  -F "[email protected]"

Python Voorbeeld

import requests

def analyseer_bloedtest(bestandspad: str, gebruikersnaam: str, wachtwoord: str, taal: str = "nl"):
    """
    Analyseer een bloedtest bestand met de Kantesti API.
    """
    url = "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze"

    with open(bestandspad, "rb") as f:
        bestanden = {"file": (bestandspad, f, "application/pdf")}
        gegevens = {
            "username": gebruikersnaam,
            "password": wachtwoord,
            "language": taal
        }

        respons = requests.post(url, files=bestanden, data=gegevens, timeout=120)
        respons.raise_for_status()
        return respons.json()

# Voorbeeldgebruik
if __name__ == "__main__":
    resultaat = analyseer_bloedtest(
        bestandspad="bloedtest.pdf",
        gebruikersnaam="uw_gebruikersnaam",
        wachtwoord="uw_wachtwoord",
        taal="nl"
    )
    print(f"Status: {resultaat['status']}")
    print(f"Gevonden parameters: {len(resultaat['data']['parameters'])}")

Referentie responsvelden

Hoofdniveau

data.metadata Object

data.parameters Array Element

data.interpretation Array Element

Volledig responsvoorbeeld

{
  "status": "success",
  "data": {
    "metadata": {
      "patient_name": "Anna Müller",
      "lab_name": "MedLab Diagnostics International",
      "lab_city": "Amsterdam",
      "lab_country": "Nederland",
      "lab_date": "2025-12-15",
      "results_date": "2025-12-16",
      "patient_age": "38",
      "patient_sex": "female"
    },
    "parameters": [
      {
        "short_name": "WBC",
        "long_name": "Witte bloedceltelling",
        "category": "Volledig bloedbeeld",
        "result": "6.8",
        "unit": "10^9/L",
        "evaluation": "normal",
        "range_min": "4.0",
        "range_max": "11.0",
        "short_description": "Meet het totale aantal witte bloedcellen.",
        "long_description": "Witte bloedcellen (leukocyten) zijn essentiële componenten van het immuunsysteem..."
      },
      {
        "short_name": "RBC",
        "long_name": "Rode bloedceltelling",
        "category": "Volledig bloedbeeld",
        "result": "4.52",
        "unit": "10^12/L",
        "evaluation": "normal",
        "range_min": "3.8",
        "range_max": "5.8",
        "short_description": "Meet het totale aantal rode bloedcellen.",
        "long_description": "Rode bloedcellen (erytrocyten) transporteren zuurstof van de longen naar de weefsels..."
      },
      {
        "short_name": "HGB",
        "long_name": "Hemoglobine",
        "category": "Volledig bloedbeeld",
        "result": "13.2",
        "unit": "g/dL",
        "evaluation": "normal",
        "range_min": "11.5",
        "range_max": "16.0",
        "short_description": "Eiwit in rode bloedcellen dat zuurstof transporteert.",
        "long_description": "Hemoglobine is het ijzerbevattende eiwit in rode bloedcellen verantwoordelijk voor zuurstoftransport..."
      },
      {
        "short_name": "GLU",
        "long_name": "Nuchtere glucose",
        "category": "Metabolisch panel",
        "result": "102",
        "unit": "mg/dL",
        "evaluation": "borderline_high",
        "range_min": "70",
        "range_max": "140",
        "short_description": "Meet het bloedsuikerniveau na vasten.",
        "long_description": "Nuchtere glucose is een belangrijke indicator van hoe het lichaam suiker verwerkt..."
      },
      {
        "short_name": "TC",
        "long_name": "Totaal cholesterol",
        "category": "Lipidenprofiel",
        "result": "218",
        "unit": "mg/dL",
        "evaluation": "borderline_high",
        "range_min": "0",
        "range_max": "300",
        "short_description": "Meet het totale cholesterol in het bloed.",
        "long_description": "Totaal cholesterol is de som van HDL-, LDL- en VLDL-cholesterol..."
      },
      {
        "short_name": "LDL",
        "long_name": "LDL-cholesterol",
        "category": "Lipidenprofiel",
        "result": "142",
        "unit": "mg/dL",
        "evaluation": "high",
        "range_min": "0",
        "range_max": "200",
        "short_description": "Meet het niveau van 'slecht' cholesterol.",
        "long_description": "LDL-cholesterol kan zich ophopen in de slagaderwanden..."
      }
    ],
    "interpretation": [
      {
        "title": "Algemene gezondheidsbeoordeling",
        "shortcode": "overall_health_assessment",
        "subsections": [
          {
            "subtitle": "Uitgebreid overzicht",
            "items": [
              {"item": "De patiënt vertoont over het algemeen gezonde hematologische parameters met alle bloedbeeldwaarden binnen de normale grenzen."},
              {"item": "Het lipidenprofiel toont gebieden die aandacht vereisen, met name de LDL-cholesterolniveaus."}
            ]
          }
        ]
      },
      {
        "title": "Aanbevelingen",
        "shortcode": "recommendations",
        "subsections": [
          {
            "subtitle": "Leefstijlaanpassingen",
            "items": [
              {"item": "Verhoog aerobe fysieke activiteit tot minimaal 150 minuten per week."},
              {"item": "Adopteer een mediterraan dieet rijk aan groenten, fruit en gezonde vetten."}
            ]
          }
        ]
      }
    ]
  },
  "api_version": "v11",
  "timestamp": "2025-12-16T14:32:18Z"
}

Genereert uitgebreide voedings- en supplementaanbevelingen op basis van bloedtestparameters en patiëntprofiel.

Patiënt Object Schema

Gedetailleerde beschrijving van alle beschikbare velden voor het patiënt object:

Responsvelden referentie

Object nutrition_plan.educational_insights

Array-element blood_marker_education

Array-element food_recommendations.power_foods

Array-element supplement_recommendations

Volledig cURL voorbeeld

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/nutrition/diet-plan/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "uw_gebruikersnaam",
    "password": "uw_wachtwoord",
    "language": "nl",
    "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"]
  }'

Volledige respons

{
  "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": "Vitamine D",
            "explanation": "Vitamine D is essentieel voor botgezondheid, immuunfunctie en stemmingsregulatie. Uw niveau van 18 ng/mL duidt op een tekort dat de calciumopname en algemene gezondheid kan beïnvloeden.",
            "normal_range": "30-50 ng/mL"
          },
          {
            "marker": "LDL-cholesterol",
            "explanation": "LDL-cholesterol, vaak 'slecht cholesterol' genoemd, kan zich ophopen in de slagaderwanden. Uw niveau van 140 mg/dL is verhoogd en kan het cardiovasculaire risico verhogen.",
            "normal_range": "< 100 mg/dL"
          }
        ],
        "nutrition_principles": [
          "Prioriteit voor omega-3 vetzuren voor hartgezondheid",
          "Verhoog oplosbare vezels om LDL-cholesterol te verlagen",
          "Neem voedingsmiddelen rijk aan vitamine D en zonlicht op"
        ]
      }
    },
    "food_recommendations": {
      "power_foods": [
        {
          "food": "Wilde zalm",
          "nutrients": ["Omega-3", "Vitamine D", "Eiwitten"],
          "serving": "150g, 3 keer per week",
          "why": "Uitstekende bron van omega-3 en natuurlijke vitamine D voor hart- en botgezondheid"
        },
        {
          "food": "Volkoren havermout",
          "nutrients": ["Bèta-glucaan", "Vezels", "Magnesium"],
          "serving": "50g per dag bij het ontbijt",
          "why": "Oplosbare vezels in havermout helpen de opname van LDL-cholesterol te verminderen"
        },
        {
          "food": "Extra vierge olijfolie",
          "nutrients": ["Enkelvoudig onverzadigde vetten", "Polyfenolen", "Vitamine E"],
          "serving": "2-3 eetlepels per dag",
          "why": "Gezonde mediterrane vetten verbeteren het lipidenprofiel en beschermen het hart"
        },
        {
          "food": "Spinazie",
          "nutrients": ["IJzer", "Foliumzuur", "Vitamine K"],
          "serving": "100g per dag, rauw of gekookt",
          "why": "Rijk aan ijzer en antioxidanten voor energie en cardiovasculaire gezondheid"
        }
      ]
    },
    "supplement_recommendations": [
      {
        "supplement": "Vitamine D3",
        "dosage": "2000-4000 IE per dag",
        "timing": "Bij het ontbijt (maaltijd met vetten)",
        "duration": "3-6 maanden, daarna opnieuw testen",
        "reason": "Uw niveau van 18 ng/mL ligt onder het optimale van 30-50 ng/mL"
      },
      {
        "supplement": "Omega-3 (EPA/DHA)",
        "dosage": "1000-2000mg EPA+DHA per dag",
        "timing": "Bij de hoofdmaaltijden",
        "duration": "Doorlopend voor hartgezondheid",
        "reason": "Helpt triglyceriden te verlagen en verbetert de HDL/LDL-verhouding"
      },
      {
        "supplement": "Co-enzym Q10",
        "dosage": "100mg per dag",
        "timing": "Bij de ochtendmaaltijd",
        "duration": "Minimaal 3 maanden",
        "reason": "Ondersteunt hartgezondheid, bijzonder belangrijk bij hypertensie"
      }
    ]
  },
  "api_version": "v1",
  "timestamp": "2025-12-22T10:30:00Z"
}

Voer trendanalyse uit op 2-50 bloedtests om langetermijnpatronen en gezondheidsveranderingen te identificeren. Verbruikt 1 credit per verzoek.

Verzoekparameters

analysis_options Object

Optionele configuratie-opties voor het aanpassen van de analyse-uitvoer:

blood_tests Array Structuur

Elk bloedtest object in de blood_tests array moet de volgende structuur hebben:

blood_tests[].parameters Structuur

Elk parameter object in de parameters array moet de volgende velden bevatten:

Referentie responsvelden

data.trend_summary Object

data.parameter_trends Array Element

data.insights Object

cURL Voorbeeld

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/analytics/trends/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "uw_gebruikersnaam",
    "password": "uw_wachtwoord",
    "language": "nl",
    "analysis_type": "comprehensive",
    "blood_tests": [
      {
        "test_date": "2024-01-15",
        "parameters": [
          {"short_name": "GLU", "result": 118, "unit": "mg/dL"},
          {"short_name": "HbA1c", "result": 6.2, "unit": "%"},
          {"short_name": "CHOL", "result": 235, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 155, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 38, "unit": "mg/dL"}
        ]
      },
      {
        "test_date": "2024-05-18",
        "parameters": [
          {"short_name": "GLU", "result": 108, "unit": "mg/dL"},
          {"short_name": "HbA1c", "result": 5.9, "unit": "%"},
          {"short_name": "CHOL", "result": 215, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 140, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 42, "unit": "mg/dL"}
        ]
      },
      {
        "test_date": "2024-08-20",
        "parameters": [
          {"short_name": "GLU", "result": 102, "unit": "mg/dL"},
          {"short_name": "HbA1c", "result": 5.6, "unit": "%"},
          {"short_name": "CHOL", "result": 200, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 128, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 48, "unit": "mg/dL"}
        ]
      },
      {
        "test_date": "2024-12-18",
        "parameters": [
          {"short_name": "GLU", "result": 95, "unit": "mg/dL"},
          {"short_name": "HbA1c", "result": 5.4, "unit": "%"},
          {"short_name": "CHOL", "result": 188, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 115, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 52, "unit": "mg/dL"}
        ]
      }
    ]
  }'

Python Voorbeeld

import requests

def analyseer_trends(bloedtests: list, gebruikersnaam: str, wachtwoord: str, taal: str = "nl"):
    """
    Voer trendanalyse uit op meerdere bloedtests.
    """
    url = "https://app.aibloodtestinterpret.com/api/v1/analytics/trends/analyze"

    payload = {
        "username": gebruikersnaam,
        "password": wachtwoord,
        "language": taal,
        "analysis_type": "comprehensive",
        "blood_tests": bloedtests
    }

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

# Voorbeeldgebruik
if __name__ == "__main__":
    bloedtests = [
        {
            "test_date": "2025-01-15",
            "parameters": [
                {"short_name": "CHOL", "result": 220, "unit": "mg/dL"},
                {"short_name": "LDL", "result": 145, "unit": "mg/dL"}
            ]
        },
        {
            "test_date": "2025-06-15",
            "parameters": [
                {"short_name": "CHOL", "result": 205, "unit": "mg/dL"},
                {"short_name": "LDL", "result": 135, "unit": "mg/dL"}
            ]
        }
    ]

    resultaat = analyseer_trends(
        bloedtests=bloedtests,
        gebruikersnaam="uw_gebruikersnaam",
        wachtwoord="uw_wachtwoord",
        taal="nl"
    )
    print(f"Totaal tests: {resultaat['data']['trend_summary']['total_tests']}")
    print(f"Algehele beoordeling: {resultaat['data']['trend_summary']['overall_assessment']}")

Genereer AI-gestuurde narratieve vergelijkingen tussen bloedtests. Verbruikt 1 credit per verzoek.

Verzoekparameters

blood_tests Array Structuur

Elk bloedtest object in de blood_tests array moet de volgende structuur hebben:

Referentie responsvelden

data.comparison_summary Object

data.parameter_comparisons Array Element

data.ai_interpretation Object

cURL Voorbeeld

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/bloodtest/comparison/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "uw_gebruikersnaam",
    "password": "uw_wachtwoord",
    "language": "nl",
    "blood_tests": [
      {
        "test_date": "2025-01-15",
        "parameters": [
          {"short_name": "CHOL", "result": 220, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 145, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 42, "unit": "mg/dL"},
          {"short_name": "TRIG", "result": 165, "unit": "mg/dL"}
        ]
      },
      {
        "test_date": "2025-12-15",
        "parameters": [
          {"short_name": "CHOL", "result": 195, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 125, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 52, "unit": "mg/dL"},
          {"short_name": "TRIG", "result": 140, "unit": "mg/dL"}
        ]
      }
    ]
  }'

Python Voorbeeld

import requests

def vergelijk_bloedtests(bloedtests: list, gebruikersnaam: str, wachtwoord: str, taal: str = "nl"):
    """
    Vergelijk bloedtests met behulp van AI-narratieve analyse.
    """
    url = "https://app.aibloodtestinterpret.com/api/v1/bloodtest/comparison/analyze"

    payload = {
        "username": gebruikersnaam,
        "password": wachtwoord,
        "language": taal,
        "blood_tests": bloedtests
    }

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

# Voorbeeldgebruik
if __name__ == "__main__":
    bloedtests = [
        {
            "test_date": "2025-01-15",
            "parameters": [
                {"short_name": "CHOL", "result": 220, "unit": "mg/dL"},
                {"short_name": "LDL", "result": 145, "unit": "mg/dL"}
            ]
        },
        {
            "test_date": "2025-12-15",
            "parameters": [
                {"short_name": "CHOL", "result": 195, "unit": "mg/dL"},
                {"short_name": "LDL", "result": 125, "unit": "mg/dL"}
            ]
        }
    ]

    resultaat = vergelijk_bloedtests(
        bloedtests=bloedtests,
        gebruikersnaam="uw_gebruikersnaam",
        wachtwoord="uw_wachtwoord",
        taal="nl"
    )
    print(f"Totaal vergeleken tests: {resultaat['data']['comparison_summary']['total_tests_compared']}")
    print(f"Algehele verandering: {resultaat['data']['comparison_summary']['overall_change']}")

Controleer uw resterende API-quota. Authenticatie vereist.

cURL Voorbeeld

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

Voorbeeld Respons

{
  "status": "success",
  "quota": {
    "remaining": 847,
    "total": 1000,
    "reset_date": "2026-01-01",
    "plan": "professional"
  }
}

Genereert een uitgebreid AI-gestuurd rapport voor familiaire gezondheidsrisicobeoordeling.

Aanvraagparameters (JSON Body)

cURL voorbeeld

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

Python voorbeeld

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

Voorbeeld respons

{"status":"success","data":{"report_data":{"report_title":"Familiaire Gezondheidsrisicobeoordeling Rapport","hereditary_risk_analysis":{"high_risk":[{"condition":"Cardiovasculaire ziekte","risk_score":75}]},"genetic_screening_recommendations":["BRCA1/BRCA2 genetische test"]}},"timestamp":"2026-03-23T10:30:00Z","api_version":"1.0.0"}

Foutcodes Family Health API

Extraheert alle tekstinhoud uit geüploade documenten met Kantesti ICR-technologie.

Verzoekparameters

cURL Voorbeeld

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

Python Voorbeeld

import requests

def icr_extract(file_path: str, username: str, password: str, language: str = "nl"):
    """
    Extraheer tekst uit een document met de Kantesti ICR API.
    79% sneller en nauwkeuriger dan traditionele OCR.
    """
    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()

result = icr_extract("medisch_rapport.pdf", "gebruikersnaam", "wachtwoord", "nl")
print(f"Documenttype: {result['data']['document_type']}")
print(f"Pagina's: {result['data']['page_count']}")

Voorbeeldrespons

{
  "status": "success",
  "data": {
    "document_type": "blood_test_report",
    "page_count": 1,
    "pages": [{"page_number": 1, "content": {"raw_text": "Universitair Ziekenhuis Keulen - Bloedbeeld...", "sections": [{"type": "header", "content": "Bloedbeeld"}], "tables": [{"headers": ["Test", "Resultaat", "Eenheid", "Referentiewaarde"], "rows": [["Glucose", "92", "mg/dL", "74 - 100"], ["ALT", "22", "U/L", "< 35"]]}]}}],
    "metadata": {"detected_language": "nl", "confidence": "high"},
    "icr_metadata": {"engine": "kantesti-icr", "version": "1.0.0"}
  },
  "credit_cost": 0.5,
  "api_version": "icr-v1"
}