Endpoints van de Bloedtest API

Productie endpoint voor bloedtestanalyse. Upload een of meer bloedtestafbeeldingen of een PDF en ontvang gestructureerde parameters, metagegevens van patiënt en laboratorium, en een volledige klinische interpretatie in elk van de 100 ondersteunde talen. Verbruikt 1 credit per verzoek.

Verzoekparameters

cURL Voorbeeld

curl -X POST "https://app.aibloodtestinterpret.com/api/v12/18-09-2026/analyze" \
  -F "username=UW_GEBRUIKERSNAAM" \
  -F "password=UW_WACHTWOORD" \
  -F "language=nl" \
  -F "[email protected]"

Python Voorbeeld

import requests

def analyze_blood_test(file_paths, username, password, language="nl"):
    """
    Analyseer een bloedtest met Kantesti Bloedtest Analyse v12.
    Geef een of meer afbeeldingen mee, of een enkele PDF.
    """
    url = "https://app.aibloodtestinterpret.com/api/v12/18-09-2026/analyze"

    handles = [open(path, "rb") for path in file_paths]
    try:
        files = [("file", (path, handle)) for path, handle in zip(file_paths, handles)]
        data = {"username": username, "password": password, "language": language}
        response = requests.post(url, files=files, data=data, timeout=300)
        response.raise_for_status()
        return response.json()
    finally:
        for handle in handles:
            handle.close()

# Voorbeeldgebruik
result = analyze_blood_test(
    file_paths=["bloedtest.pdf"],
    username="gebruikersnaam",
    password="wachtwoord",
    language="nl"
)
print(f"Status: {result['status']}")
for param in result["data"]["parameters"]:
    print(f"  {param['short_name']}: {param['result']} {param['unit']} ({param['evaluation']})")

Voorbeeldrespons

{
  "status": "success",
  "api_version": "v12",
  "data": {
    "metadata": {
      "patient_name": "Jan Novak",
      "patient_age": "45",
      "patient_sex": "Male",
      "lab_name": "BioLAB Medical Center",
      "lab_city": "Prague",
      "lab_country": "Czech Republic",
      "lab_date": "2026-09-11",
      "results_date": "2026-09-12"
    },
    "parameters": [
      {"short_name": "Glucose", "long_name": "Fasting Blood Glucose", "result": "92", "unit": "mg/dL", "reference_range": "74 - 100", "range_normal_min": 74, "range_normal_max": 100, "type": "range", "evaluation": "normal"},
      {"short_name": "ALT", "long_name": "Alanine aminotransferase", "result": "65", "unit": "U/L", "reference_range": "< 45", "range_normal_min": 7, "range_normal_max": 45, "type": "range", "evaluation": "high"},
      {"short_name": "Creatinine", "long_name": "Creatinine", "result": "0.9", "unit": "mg/dL", "reference_range": "0.7 - 1.2", "range_normal_min": 0.7, "range_normal_max": 1.2, "type": "range", "evaluation": "normal"}
    ],
    "interpretation": [
      {"shortcode": "overview", "item": "Most parameters are within their reference ranges."},
      {"shortcode": "key_findings", "item": "Alanine aminotransferase is above the reference range, which warrants a follow-up liver panel."}
    ]
  },
  "timestamp": "2026-09-18T10:30:00Z"
}

Productie endpoint met uitgebreide berekening van de gezondheidsscore en analyse van ziekterisico's. Neemt hetzelfde verzoek aan als /api/v12/18-09-2026/analyze en voegt de onderstaande velden toe aan de respons. Verbruikt 1 credit per verzoek.

cURL Voorbeeld

curl -X POST "https://app.aibloodtestinterpret.com/api/v12/health-score/analyze" \
  -F "username=UW_GEBRUIKERSNAAM" \
  -F "password=UW_WACHTWOORD" \
  -F "language=nl" \
  -F "[email protected]"

Aanvullende responsvelden

{
  "health_score": {
    "overall": 78,
    "optimal": 4,
    "normal": 12,
    "warning": 3,
    "critical": 1,
    "total_parameters": 20,
    "score_interpretation": "good",
    "recommendations": [
      "Consider increasing vitamin D intake",
      "Schedule follow-up for cholesterol levels"
    ]
  },
  "disease_risks": [
    {"name": "Cardiovascular Disease", "percentage": "18%", "severity": "low"},
    {"name": "Type 2 Diabetes", "percentage": "12%", "severity": "low"},
    {"name": "Metabolic Syndrome", "percentage": "25%", "severity": "moderate"}
  ]
}

Productie endpoint voor bloedtestanalyse. 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

Plaatst elk gemarkeerd resultaat uit een laboratoriumpanel op het lichaam. Verbruikt 1 credit per geslaagd verzoek. Een verzoek dat de validatie niet doorstaat, of waarvan de gemarkeerde markers niet geplaatst kunnen worden, wordt niet in rekening gebracht.

Verzoekparameters

Velden van het parameterobject

cURL Voorbeeld

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/body-map/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "UW_GEBRUIKERSNAAM",
    "password": "UW_WACHTWOORD",
    "parameters": [
      {"short_name": "ALT", "long_name": "Alanine aminotransferase", "result": "65", "unit": "U/L", "range_normal_min": 7, "range_normal_max": 45, "evaluation": "high"},
      {"short_name": "AST", "long_name": "Aspartate aminotransferase", "result": "48", "unit": "U/L", "range_normal_min": 8, "range_normal_max": 40, "evaluation": "slightly_high"},
      {"short_name": "TSH", "long_name": "Thyrotropin", "result": "6.2", "unit": "mIU/L", "range_normal_min": 0.4, "range_normal_max": 4.0, "evaluation": "high"}
    ]
  }'

Python Voorbeeld

import requests

def build_body_map(parameters, username, password, include_image=False):
    """
    Plaats bloedtestresultaten buiten de referentiewaarden op het lichaam.
    Retourneert de regio's, de legenda en de URL's van de illustratie.
    """
    url = "https://app.aibloodtestinterpret.com/api/v1/body-map/analyze"

    response = requests.post(url, json={
        "username": username,
        "password": password,
        "parameters": parameters,
        "include_image": include_image,
    }, timeout=60)
    response.raise_for_status()
    return response.json()

# Voorbeeldgebruik
result = build_body_map(
    parameters=[
        {"short_name": "ALT", "result": "65", "unit": "U/L", "evaluation": "high"},
        {"short_name": "TSH", "result": "6.2", "unit": "mIU/L", "evaluation": "high"},
    ],
    username="gebruikersnaam",
    password="wachtwoord",
)

body_map = result["data"]["body_map"]
for region in body_map["regions"]:
    ernst = "buiten referentie" if region["level"] == 2 else "grenswaarde"
    print(f"  {region['key']}: {ernst} ({', '.join(region['markers'])})")
print(f"Illustratie: {body_map['image_url'] or body_map['fallback_url']}")

Voorbeeldrespons

{
  "status": "success",
  "api_version": "1.0.0",
  "message": "Body map generated successfully",
  "data": {
    "body_map": {
      "v": 4,
      "spec": "v4-thy2-liv2",
      "unmapped": 0,
      "image_url": "/static/body_maps/v4-thy2-liv2.webp",
      "fallback_url": "/body-map/v4-thy2-liv2.0123456789abcdef.webp",
      "regions": [
        {"key": "thyroid", "level": 2, "drawn": true, "markers": ["TSH"]},
        {"key": "liver", "level": 2, "drawn": true, "markers": ["ALT", "AST"]}
      ]
    },
    "engine_version": 4,
    "region_keys": ["brain_nerves", "thyroid", "heart_vessels", "liver", "pancreas", "adrenals", "kidneys", "gut", "reproductive", "blood", "immune", "bones", "muscles"],
    "mode": "deterministic",
    "all_clear": false
  },
  "timestamp": "2026-09-18T10:30:00Z"
}

Referentie responsvelden

Controleert een payload zonder de analyse uit te voeren en meldt welke van uw analytnamen de engine herkent, onder recognised en unrecognised. Authenticatie is vereist; er wordt geen quota verbruikt en het endpoint blijft werken op een account zonder resterende credits.

Geeft de 13 lichaamsregio's in canonieke volgorde terug, samen met de ernstniveaus. Gebruik dit om uw eigen vertalingen van de legenda op te bouwen.

Metagegevens over de mogelijkheden: of de engine op deze deployment ingeschakeld is, de verzoeklimieten, het authenticatieschema en de volledige lijst met endpoints.

Berekent de biologische bloedleeftijd en de afgeleide indices uit een laboratoriumpanel. Verbruikt 1 credit per geslaagd verzoek. Een verzoek dat de validatie niet doorstaat, of waarvan het panel niets berekenbaars oplevert, wordt niet in rekening gebracht.

Verzoekparameters

De negen PhenoAge-markers

Stuur ze onder de namen die uw laboratorium heeft afgedrukt — de herkenning gebeurt op naam, in elk van de 39 ondersteunde rapporttalen, en eenheden worden automatisch omgerekend.

cURL Voorbeeld

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/blood-age/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "UW_GEBRUIKERSNAAM",
    "password": "UW_WACHTWOORD",
    "metadata": {"patient_age": "40", "patient_sex": "Male", "lab_date": "2026-09-11"},
    "parameters": [
      {"short_name": "Albumin", "result": 4.4, "unit": "g/dL"},
      {"short_name": "Creatinine", "result": 0.9, "unit": "mg/dL"},
      {"short_name": "Glucose", "result": 90, "unit": "mg/dL"},
      {"short_name": "CRP", "result": 1.0, "unit": "mg/L"},
      {"short_name": "Lymphocytes", "result": 30, "unit": "%"},
      {"short_name": "MCV", "result": 90, "unit": "fL"},
      {"short_name": "RDW", "result": 13, "unit": "%"},
      {"short_name": "ALP", "result": 70, "unit": "U/L"},
      {"short_name": "WBC", "result": 6.0, "unit": "10^9/L"}
    ]
  }'

Python Voorbeeld

import requests

def biological_blood_age(parameters, metadata, username, password):
    """
    Bereken de biologische bloedleeftijd uit een routinebloedpanel.
    De metagegevens dragen patient_age en patient_sex aan.
    """
    url = "https://app.aibloodtestinterpret.com/api/v1/blood-age/analyze"

    response = requests.post(url, json={
        "username": username,
        "password": password,
        "parameters": parameters,
        "metadata": metadata,
    }, timeout=60)
    response.raise_for_status()
    return response.json()

# Voorbeeldgebruik
result = biological_blood_age(
    parameters=[
        {"short_name": "Albumin", "result": 4.4, "unit": "g/dL"},
        {"short_name": "Creatinine", "result": 0.9, "unit": "mg/dL"},
        {"short_name": "Glucose", "result": 90, "unit": "mg/dL"},
        {"short_name": "CRP", "result": 1.0, "unit": "mg/L"},
        {"short_name": "Lymphocytes", "result": 30, "unit": "%"},
        {"short_name": "MCV", "result": 90, "unit": "fL"},
        {"short_name": "RDW", "result": 13, "unit": "%"},
        {"short_name": "ALP", "result": 70, "unit": "U/L"},
        {"short_name": "WBC", "result": 6.0, "unit": "10^9/L"},
    ],
    metadata={"patient_age": "40", "patient_sex": "Male"},
    username="gebruikersnaam",
    password="wachtwoord",
)

samenvatting = result["data"]["summary"]
print(f"Kalenderleeftijd:  {samenvatting['chronological_age']}")
print(f"Biologisch:        {samenvatting['biological_age']} ({samenvatting['source']})")
print(f"Verschil:          {samenvatting['delta_years']:+} jaar")

Voorbeeldrespons

{
  "status": "success",
  "api_version": "1.0.0",
  "message": "Biological blood age computed successfully",
  "data": {
    "blood_age": {
      "version": 1,
      "age": {
        "status": "ok",
        "source": "formula",
        "chrono": 40,
        "pheno": 35.1,
        "delta": -4.9,
        "sex": "m",
        "found": ["albumin", "creatinine", "glucose", "crp", "lymph", "mcv", "rdw", "alp", "wbc"],
        "missing": [],
        "inputs": {"albumin": 44.0, "creatinine": 79.56, "glucose": 5.0}
      },
      "indices": [
        {"key": "fib4", "group": "liver", "value": 1.12, "unit": "", "band": "ok", "from": ["AST", "ALT", "PLT"]},
        {"key": "egfr", "group": "kidneys", "value": 98.0, "unit": "mL/min/1.73m2", "band": "ok", "from": ["Creatinine"]},
        {"key": "nlr", "group": "immune", "value": 1.8, "unit": "", "band": "ok", "from": ["Neutrophils", "Lymphocytes"]}
      ]
    },
    "engine_version": 1,
    "mode": "deterministic",
    "summary": {
      "status": "ok",
      "source": "formula",
      "chronological_age": 40,
      "biological_age": 35.1,
      "delta_years": -4.9,
      "sex": "m",
      "markers_found": 9,
      "markers_missing": [],
      "indices_count": 3
    }
  },
  "timestamp": "2026-09-18T10:30:00Z"
}

Referentie responsvelden

Controleert een payload zonder de analyse uit te voeren en meldt welke van de negen PhenoAge-markers uw panel aanlevert en of er een kalenderleeftijd gelezen kon worden — de twee dingen die bepalen of u de volledige formule of de gedeeltelijke schatting krijgt. Authenticatie is vereist; er wordt geen quota verbruikt en het endpoint blijft werken op een account zonder resterende credits.

Geeft de negen PhenoAge-invoerwaarden terug, elke marker die de engine kan lezen met zijn doeleenheid, en het leeftijdsbereik waarvoor de formule geldt.

Metagegevens over de mogelijkheden: of de engine op deze deployment ingeschakeld is, de twee modi en wat elk daarvan kost, de verzoeklimieten, het authenticatieschema en de ondersteunde talen.

Interpreteert één DNA-test en retourneert een uitgebreid genetisch gezondheidsrapport. Stuur een bestand als multipart/form-data, of geplakte genotyperegels als JSON. De upload wordt direct tijdens het verzoek ingelezen, zodat een onleesbaar bestand meteen een 400 oplevert en niets kost. Er wordt pas één credit afgeschreven nadat het rapport is opgesteld.

Verzoekparameters

cURL Voorbeeld

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/dna-interpretation/analyze?async=1" \
  -u "UW_GEBRUIKERSNAAM:UW_WACHTWOORD" \
  -F "file=@genome_raw_data.txt" \
  -F "language=en" \
  -F 'patient={"age": 41, "sex": "female", "medications": "clopidogrel"}'

# Antwoord 202 Accepted: {"status": "pending", "job_id": "...", "poll_url": "/api/jobs/...", ...}
curl -u "UW_GEBRUIKERSNAAM:UW_WACHTWOORD" "https://app.aibloodtestinterpret.com/api/jobs/JOB_ID"

Python Voorbeeld

import time
import requests

BASE = "https://app.aibloodtestinterpret.com"
AUTH = ("UW_GEBRUIKERSNAAM", "UW_WACHTWOORD")


def run(path, poll=True, **kwargs):
    """POST in asynchrone modus en poll daarna /api/jobs/<id> tot het rapport klaar is."""
    resp = requests.post(f"{BASE}{path}?async=1", auth=AUTH, timeout=60, **kwargs)
    body = resp.json()
    if resp.status_code != 202:
        return body                      # een fout, of een synchroon antwoord
    while True:
        time.sleep(body.get("poll_interval_ms", 3000) / 1000)
        job = requests.get(f"{BASE}{body['poll_url']}", auth=AUTH, timeout=30).json()
        if job["status"] in ("completed", "failed"):
            return job["result"]["response"]


# 1) DNA-testinterpretatie
with open("genome_raw_data.txt", "rb") as fh:
    dna = run("/api/v1/dna-interpretation/analyze",
              files={"file": fh},
              data={"language": "en", "patient": '{"age": 41, "sex": "female"}'})
report = dna["data"]["report"]
print(report["executive_summary"])
for section in report["sections"]:
    print(section["title"], "-", section["risk_level"])

Voorbeeldrespons

{
  "status": "success",
  "api_version": "1.0.0",
  "message": "DNA test interpretation completed successfully",
  "data": {
    "analysis_id": "DNA-3F9A1C07B2",
    "module": "dna_interpretation",
    "generated_at": "2026-09-23T10:30:00Z",
    "language": "en",
    "source": {
      "kind": "raw", "format": "23andme", "build": "GRCh37",
      "total_records": 638463, "called": 631022, "no_call_rate": 0.0117,
      "inferred_sex": "female", "panel_total": 334, "panel_found": 291,
      "filename": "genome_raw_data.txt", "warnings": []
    },
    "report": {
      "report_type": "dna",
      "title": "Genetic health report",
      "executive_summary": "Array genotyping with good coverage of the clinical panel...",
      "overall_assessment": {"level": "slightly_elevated", "summary": "Mostly typical findings with a few actionable ones."},
      "data_quality": {"source": "23andMe v5 raw file", "markers_analyzed": 291, "coverage_note": "...", "limitations": "..."},
      "sections": [
        {
          "key": "nutrigenomics", "title": "Nutrient metabolism", "risk_level": "slightly_elevated",
          "summary": "Reduced folate cycle activity...",
          "findings": [
            {"gene": "MTHFR", "rsid": "rs1801133", "genotype": "AG", "phenotype": "C677T heterozygous",
             "risk_level": "slightly_elevated", "evidence": "established",
             "explanation": "About 65% of typical enzyme activity.", "recommendation": "Check homocysteine."}
          ]
        }
      ],
      "pharmacogenomics": [
        {"gene": "CYP2C19", "rsids": ["rs4244285"], "predicted_phenotype": "Intermediate metabolizer",
         "affected_drugs": ["clopidogrel", "omeprazole"], "recommendation": "Review before prescribing clopidogrel."}
      ],
      "disease_risks": [], "carrier_status": [], "nutrigenomics": [], "traits": [],
      "lifestyle_recommendations": ["..."], "recommended_tests": [{"test": "Homocysteine", "reason": "MTHFR C677T"}],
      "red_flags": [], "limitations": "Consumer arrays miss rare variants.",
      "disclaimer": "AI-generated clinical decision support for clinician review; not a diagnosis."
    }
  },
  "timestamp": "2026-09-23T10:30:00Z"
}

Referentie responsvelden

Leest de upload precies zo in als /analyze en meldt wat er is gevonden, zonder AI-aanroep. Authenticatie is vereist; er wordt geen credit verbruikt. Gebruik dit endpoint om een bestand te controleren voordat u een credit besteedt.

Voorbeeldrespons

{
  "status": "success",
  "message": "Payload is valid",
  "data": {
    "valid": true,
    "language": "en",
    "source": {"kind": "raw", "format": "ancestrydna", "build": "GRCh37", "panel_total": 334, "panel_found": 287, "warnings": []}
  }
}

Combineert een DNA-rapport met een geïnterpreteerde bloedtest tot één gezondheidsrapport. Elk verband tussen een genetische bevinding en een labwaarde wordt geclassificeerd, gevolgd door een risicomatrix, prioritaire acties en een monitoringplan. Eén credit per geslaagd verzoek.

Verzoekparameters

Python Voorbeeld

# 2) DNA + bloedgezondheidsrapport (gebruikt run() en dna uit het voorbeeld hierboven)
blood_test = {
    "parameters": [
        {"short_name": "25-OH D", "result": 18, "unit": "ng/mL", "range_normal_min": 30, "range_normal_max": 100, "evaluation": "low"},
        {"short_name": "Homocysteine", "result": 13.2, "unit": "µmol/L", "evaluation": "high"}
    ]
}
combined = run("/api/v1/dna-blood-report/analyze",
               json={"dna_report": dna, "blood_test": blood_test, "language": "en"})
for link in combined["data"]["report"]["correlations"]:
    print(link["topic"], link["concordance"], link["action"])

Voorbeeldrespons

{
  "status": "success",
  "message": "DNA + blood health report completed successfully",
  "data": {
    "analysis_id": "DNB-8C21E40A9D",
    "module": "dna_blood_report",
    "language": "en",
    "report": {
      "report_type": "dna_blood",
      "executive_summary": "The low vitamin D level matches the GC genotype; homocysteine is borderline, in line with MTHFR C677T.",
      "overall_status": {"level": "watch", "summary": "Two gene-lab matches to act on."},
      "correlations": [
        {"topic": "Vitamin D", "genetic_finding": "GC rs2282679 GT", "lab_finding": "25-OH D 18 ng/mL",
         "concordance": "confirms", "interpretation": "Genetic tendency and lab value agree.", "action": "Supplement and recheck in 12 weeks."}
      ],
      "risk_matrix": [{"area": "Folate cycle", "genetic_risk": "slightly_elevated", "lab_status": "borderline", "combined_assessment": "Watch homocysteine."}],
      "priority_actions": [{"priority": "high", "action": "Start vitamin D3", "why": "Deficient level and GC genotype"}],
      "monitoring_plan": [{"marker": "25-OH vitamin D", "interval": "12 weeks", "reason": "Dose check"}],
      "lifestyle_plan": [], "questions_for_clinician": [], "red_flags": [],
      "limitations": "One blood test; values vary.",
      "disclaimer": "AI-generated clinical decision support for clinician review; not a diagnosis."
    }
  }
}

Referentie responsvelden

Stelt een persoonlijk supplementenplan op uit het DNA-rapport, de antwoorden op de vragenlijst en, optioneel, een geïnterpreteerde bloedtest. De productcatalogus en de adviseurinstellingen van uw kliniek worden automatisch toegepast. Eén credit per geslaagd verzoek.

Verzoekparameters

cURL Voorbeeld

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/dna-supplements/analyze?async=1" \
  -u "UW_GEBRUIKERSNAAM:UW_WACHTWOORD" \
  -H "Content-Type: application/json" \
  -d '{
    "dna_report": { ...data.report uit de DNA-interpretatie... },
    "answers": {"diet_type": "vegetarian", "pregnancy": "no", "sun_exposure": "low", "goals": ["energy", "immunity"]},
    "language": "en"
  }'

Python Voorbeeld

# 3) Supplementenplan (gebruikt run(), dna en blood_test uit de voorbeelden hierboven)
plan = run("/api/v1/dna-supplements/analyze",
           json={"dna_report": dna, "blood_test": blood_test,
                 "answers": {"diet_type": "vegetarian", "pregnancy": "no"},
                 "language": "en"})
for item in plan["data"]["report"]["recommendations"]:
    print(item["name"], item["dose"], item["timing"], "-", item["source"])

Voorbeeldrespons

{
  "status": "success",
  "message": "Supplement plan completed successfully",
  "data": {
    "analysis_id": "SUP-51B7D2E6F0",
    "module": "dna_supplements",
    "language": "en",
    "catalogue": {"mode": "prefer", "products": 24},
    "report": {
      "report_type": "supplement",
      "summary": "Plan built from GC and MTHFR findings, a low vitamin D level and a vegetarian diet.",
      "recommendations": [
        {"name": "Vitamin D3 + K2", "source": "clinic_library", "product": "Vitamin D3 + K2 (Clinic Brand)",
         "form": "softgel", "dose": "2000 IU", "timing": "with lunch", "duration": "12 weeks", "priority": "high",
         "rationale": {"genetic": "GC rs2282679 GT", "lab": "25-OH D 18 ng/mL", "questionnaire": "little sun"},
         "evidence": "established", "cautions": ["Recheck calcium"], "interactions": ["Thiazide diuretics"],
         "retest": "25-OH D in 12 weeks"}
      ],
      "avoid_or_caution": [{"name": "High-dose vitamin A", "reason": "Pregnancy planning"}],
      "uncovered_needs": [],
      "dietary_sources": [{"nutrient": "Folate", "foods": ["lentils", "spinach"]}],
      "retest_plan": [{"marker": "25-OH vitamin D", "when": "12 weeks", "why": "Dose check"}],
      "clinician_review_required": ["Thiazide co-medication"],
      "disclaimer": "AI-generated clinical decision support for clinician review; not a diagnosis."
    }
  }
}

Referentie responsvelden

Leest of wijzigt de productcatalogus van uw kliniek en de instellingen van de adviseur. Het is dezelfde catalogus als in het kliniekpaneel en in Nutrition Diet AI, dus een product dat u op één plek toevoegt, is overal beschikbaar. Authenticatie is vereist; er wordt geen credit verbruikt. Stuur catalogue, settings of beide; de catalogus vervangt de volledige lijst.

cURL Voorbeeld

curl -X PUT "https://app.aibloodtestinterpret.com/api/v1/dna-supplements/settings" \
  -u "UW_GEBRUIKERSNAAM:UW_WACHTWOORD" \
  -H "Content-Type: application/json" \
  -d '{
    "catalogue": [
      {"name": "Vitamin D3 + K2", "brand": "Clinic Brand", "form": "softgel", "dosage": "2000 IU / 75 µg", "category": "vitamin"},
      {"name": "Omega-3 EPA/DHA", "brand": "Clinic Brand", "form": "softgel", "dosage": "1000 mg", "category": "omega"}
    ],
    "settings": {"mode": "prefer", "instructions": "Prefer our own brand.", "max_items": 8}
  }'

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"
}