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

Het productie-endpoint (/analyze) en de sandbox retourneren dezelfde structuur. JSON-sleutels en codes zijn altijd in het Engels; alle tekst staat in de via language gevraagde taal (sandbox-tekst is altijd in het Engels). Toon geen sleutels of codes aan gebruikers: neem titels uit labels en toon priority_label en source_label voor de prioriteit en de bron van een supplement. Elke dag van weekly_meal_plan, van monday tot en met sunday, heeft dezelfde maaltijden: die van meal_frequency (standaard vijf).

Het plan wordt geschreven in 39 talen: en, de, fr, it, es, pt, ar, he, el, pl, tr, zh, ru, fa, ja, ko, nl, hi, id, th, vi, sv, no, da, fi, cs, ms, af, uk, ro, hu, sk, sl, hr, bg, sr, lv, lt, et. Elke andere ondersteunde taalcode (language) retourneert het plan en de bijbehorende labels in het Engels.

Object data

Object nutrition_plan

Object nutrition_plan.nutrition_summary

Object weekly_meal_plan.<day>

Een dag heeft precies de maaltijden van meal_frequency, en metadata.meal_slots somt ze op: met 2 alleen lunch en dinner. Toon de maaltijden die een dag heeft, geen vaste lijst van vijf.

Object breakfast / lunch / dinner

Array-element food_recommendations.power_foods

Array-element food_recommendations.foods_to_limit

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": 5,
      "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": {
    "analysis_id": "NUT-1A2B3C4D",
    "generated_at": "2026-11-04T10:30:00Z",
    "patient_summary": {
      "age": 34,
      "gender": "female",
      "weight": 62,
      "height": 165,
      "conditions": [],
      "dietary_preferences": "omnivore"
    },
    "nutrition_plan": {
      "nutrition_summary": {
        "daily_calories": 2046,
        "macro_distribution": {
          "protein_g": 153,
          "fat_g": 57,
          "carbs_g": 230,
          "fiber_g": 29
        },
        "key_focus_areas": [
          "Rebuild iron stores (low ferritin and haemoglobin)",
          "Raise vitamin D into the optimal range",
          "Lower LDL cholesterol with fibre and unsaturated fats"
        ],
        "primary_recommendations": [
          "Eat a heme-iron source (red meat, poultry, fish or shellfish) at least once a day",
          "Pair plant iron with vitamin C and keep tea and coffee one hour away from meals",
          "Have oily fish 2-3 times a week and oats, legumes or psyllium every day"
        ]
      },
      "weekly_meal_plan": {
        "monday": {
          "breakfast": {
            "main_dish": "Spinach and mushroom omelette (2 eggs) on wholegrain toast",
            "sides": ["Orange segments", "Cherry tomatoes"],
            "calories": 510,
            "protein": 30,
            "preparation_time": "15 minutes",
            "cost_estimate": "$3-4"
          },
          "morning_snack": {
            "items": ["Pumpkin seeds (30 g)", "Kiwi"],
            "calories": 150
          },
          "lunch": {
            "main_dish": "Lentil and vegetable soup",
            "sides": ["Wholegrain bread", "Red pepper salad with lemon"],
            "calories": 640,
            "protein": 32,
            "preparation_time": "25 minutes",
            "cost_estimate": "$3-5"
          },
          "afternoon_snack": {
            "items": ["Greek yogurt (150 g)", "Strawberries"],
            "calories": 150
          },
          "dinner": {
            "main_dish": "Grilled lean beef steak (150 g)",
            "sides": ["Roasted sweet potato", "Steamed broccoli with lemon"],
            "calories": 600,
            "protein": 45,
            "preparation_time": "30 minutes",
            "cost_estimate": "$6-8"
          }
        }
        // "tuesday" ... "sunday": the same meals as "monday"
      },
      "food_recommendations": {
        "power_foods": [
          {
            "name": "Lean red meat (beef, lamb)",
            "benefits": "Heme iron is absorbed two to three times better than plant iron and refills ferritin fastest; also supplies B12 and zinc.",
            "serving_size": "120-150 g",
            "frequency": "3 times a week",
            "blood_marker_impact": "Ferritin, Hemoglobin"
          },
          {
            "name": "Mussels and clams",
            "benefits": "Among the richest heme-iron foods, with B12 and omega-3 fats.",
            "serving_size": "100 g (cooked, shelled)",
            "frequency": "Once a week",
            "blood_marker_impact": "Ferritin, Hemoglobin"
          }
          // 12-15 foods in a live plan
        ],
        "foods_to_limit": [
          {
            "name": "Tea and coffee with meals",
            "reason": "Tannins and polyphenols can cut iron absorption from a meal by more than half.",
            "alternative": "Drink them at least one hour before or after eating; water or rooibos with meals",
            "impact_on_health": "Slows the rebuilding of ferritin"
          },
          {
            "name": "Processed meats (sausages, salami, bacon)",
            "reason": "High in saturated fat and salt, which raise LDL and blood pressure.",
            "alternative": "Grilled chicken, turkey or lean beef",
            "impact_on_health": "Keeps LDL cholesterol high"
          }
          // 12-15 foods in a live plan
        ],
        "hydration": {
          "daily_water": "3.1 L",
          "timing": "A glass on waking, then evenly through the day; less in the hour before bed",
          "special_considerations": "Keep tea and coffee at least one hour away from iron-rich meals"
        }
      },
      "supplement_recommendations": [
        {
          "name": "Iron bisglycinate",
          "dosage": "25 mg elemental iron a day",
          "timing": "In the morning on an empty stomach, with vitamin C",
          "reason": "Ferritin 14 ng/mL and haemoglobin 11.8 g/dL show depleted iron stores",
          "duration": "3 months, then retest ferritin",
          "contraindications": "Haemochromatosis; take 2 hours apart from calcium, antacids and thyroid medication",
          "source": "evidence_based",
          "priority": "high",
          "blood_marker_addressed": "Ferritin, Hemoglobin",
          "priority_label": "High",
          "source_label": "Evidence-Based"
        },
        {
          "name": "Vitamin D3",
          "dosage": "2000 IU a day",
          "timing": "With the largest meal of the day",
          "reason": "Vitamin D 18 ng/mL is below the 30 ng/mL threshold",
          "duration": "3 months, then retest",
          "contraindications": "Hypercalcaemia, sarcoidosis",
          "source": "evidence_based",
          "priority": "high",
          "blood_marker_addressed": "Vitamin D (25-OH)",
          "priority_label": "High",
          "source_label": "Evidence-Based"
        }
        // 5-8 supplements in a live plan
      ],
      "lifestyle_integration": {
        "meal_prep_tips": [
          "Cook a large pot of lentils or chickpeas on Sunday for three lunches",
          "Keep cut peppers and kiwi ready to add vitamin C to meals",
          "Portion nuts and seeds into small boxes for snacks"
        ],
        "shopping_list": {
          "proteins": ["Lean beef", "Salmon", "Sardines", "Mussels", "Chicken liver", "Eggs"],
          "vegetables": ["Spinach", "Kale", "Broccoli", "Bell peppers", "Tomatoes"],
          "fruits": ["Kiwi", "Oranges", "Strawberries", "Dried apricots"],
          "grains": ["Oats", "Quinoa", "Brown rice", "Wholegrain bread"],
          "dairy_alternatives": ["Greek yogurt", "Kefir", "Cottage cheese"],
          "pantry_staples": ["Lentils", "Chickpeas", "Pumpkin seeds", "Olive oil", "Psyllium husk"]
        },
        "eating_schedule": {
          "breakfast": "07:30-08:30",
          "morning_snack": "10:30",
          "lunch": "12:30-13:30",
          "afternoon_snack": "16:00",
          "dinner": "19:00-20:00"
        },
        "special_occasions": "When eating out, choose grilled meat or fish with salad, and keep coffee for after the meal."
      },
      "monitoring_plan": {
        "weekly_goals": [
          "Heme iron at least 5 days a week",
          "Oily fish twice a week",
          "No tea or coffee within an hour of meals"
        ],
        "tracking_metrics": [
          "Energy levels",
          "Fatigue and breathlessness",
          "Weight",
          "Digestive tolerance of the iron supplement"
        ],
        "adjustment_signs": [
          "Constipation or stomach upset from the iron supplement",
          "No improvement in energy after 6 weeks"
        ],
        "follow_up_tests": [
          "Ferritin, iron and haemoglobin in 8-12 weeks",
          "Vitamin D (25-OH) in 3 months",
          "Lipid panel in 3 months"
        ],
        "expected_improvements": [
          "Ferritin up 15-30 ng/mL within 3 months",
          "Vitamin D above 30 ng/mL within 3 months",
          "LDL down 10-15% within 3 months"
        ]
      },
      "educational_insights": {
        "blood_test_connections": [
          {
            "parameter": "Ferritin",
            "current_value": "14 ng/mL",
            "dietary_impact": "Iron stores are low; heme iron and vitamin C with meals refill them fastest.",
            "foods_that_help": ["Lean red meat", "Mussels", "Chicken liver", "Lentils with peppers"]
          },
          {
            "parameter": "Hemoglobin",
            "current_value": "11.8 g/dL",
            "dietary_impact": "Slightly below range, consistent with iron deficiency; it rises as ferritin recovers.",
            "foods_that_help": ["Beef", "Spinach with lemon", "Eggs"]
          }
          // one entry per relevant blood test parameter
        ],
        "nutritional_science": [
          "Heme iron from animal foods is absorbed at 15-35%, plant iron at 2-20%.",
          "Vitamin C turns plant iron into a form the gut absorbs more easily.",
          "Beta-glucan from oats forms a gel that carries cholesterol-rich bile out of the body."
        ],
        "success_strategies": [
          "Plan the week's meals and shop once",
          "Add a vitamin C food to every iron-rich meal",
          "Retest on schedule to see the progress"
        ]
      },
      "metadata": {
        "generated_at": "2026-11-04T10:30:00",
        "patient_id": "api_1a2b3c4d",
        "bmr": 1320.25,
        "tdee": 2046.39,
        "nutritional_concerns": ["vitamin_d_deficiency", "anemia", "iron_deficiency", "elevated_ldl"],
        "version": "2.2",
        "used_clinic_supplements": false,
        "clinic_supplements_count": 0,
        "report_language": "english",
        "meal_slots": ["breakfast", "morning_snack", "lunch", "afternoon_snack", "dinner"],
        "meal_frequency": "3 meals and 2 snacks a day (breakfast, morning snack, lunch, afternoon snack, dinner)",
        "budget": "moderate",
        "api_provider": "KantestiAI Engine",
        "model": "KantestiAI Engine"
      }
    },
    "labels": {
      "nutrition_summary": "Nutrition Summary",
      "key_focus_areas": "Key Focus Areas",
      "weekly_meal_plan": "Weekly Meal Plan",
      "monday": "Monday",
      "breakfast": "Breakfast",
      "morning_snack": "Morning Snack",
      "main_dish": "Main Dish",
      "supplement_recommendations": "Supplement Recommendations",
      "priority": "Priority",
      "high": "High",
      "evidence_based": "Evidence-Based"
      // ... one entry for every key of nutrition_plan and every priority / source code
    },
    "language": "en",
    "sandbox_mode": false
  },
  "timestamp": "2026-11-04T10:30:00Z",
  "api_version": "1.0.0",
  "message": "Nutrition analysis completed successfully"
}

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