Punkty końcowe API badań krwi

Punkt końcowy produkcyjny dla analizy badań krwi. Prześlij jeden lub więcej obrazów badania krwi albo plik PDF, a otrzymasz ustrukturyzowane parametry, metadane pacjenta i laboratorium oraz pełną interpretację kliniczną w dowolnym ze 100 obsługiwanych języków. Zużywa 1 kredyt na żądanie.

Parametry Żądania

Przykład cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v12/18-09-2026/analyze" \
  -F "username=TWOJA_NAZWA" \
  -F "password=TWOJE_HASLO" \
  -F "language=pl" \
  -F "file=@badanie_krwi.pdf"

Przykład Python

import requests

def analyze_blood_test(file_paths, username: str, password: str, language: str = "pl"):
    """
    Analizuje badanie krwi za pomocą Kantesti Blood Test Analysis v12.
    Przyjmuje kilka obrazów lub pojedynczy plik 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()

result = analyze_blood_test(["badanie_krwi.pdf"], "uzytkownik", "haslo", "pl")
print(f"Status: {result['status']}")
for param in result["data"]["parameters"]:
    print(f"  {param['short_name']}: {param['result']} {param['unit']} ({param['evaluation']})")

Przykładowa odpowiedź

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

Punkt końcowy produkcyjny dla analizy badań krwi. Zużywa 1 kredyt na żądanie.

Parametry Żądania

Przykład cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze" \
  -F "username=TWOJA_NAZWA_UZYTKOWNIKA" \
  -F "password=TWOJE_HASLO" \
  -F "language=pl" \
  -F "file=@badanie_krwi.pdf"

Przykład Python

import requests

def analizuj_badanie_krwi(sciezka_pliku: str, nazwa_uzytkownika: str, haslo: str, jezyk: str = "pl"):
    """
    Analizuje plik badania krwi za pomocą API Kantesti.
    """
    url = "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze"

    with open(sciezka_pliku, "rb") as f:
        pliki = {"file": (sciezka_pliku, f, "application/pdf")}
        dane = {
            "username": nazwa_uzytkownika,
            "password": haslo,
            "language": jezyk
        }

        odpowiedz = requests.post(url, files=pliki, data=dane, timeout=120)
        odpowiedz.raise_for_status()
        return odpowiedz.json()

# Przykład użycia
if __name__ == "__main__":
    wynik = analizuj_badanie_krwi(
        sciezka_pliku="badanie_krwi.pdf",
        nazwa_uzytkownika="twoja_nazwa_uzytkownika",
        haslo="twoje_haslo",
        jezyk="pl"
    )
    print(f"Status: {wynik['status']}")
    print(f"Znalezione parametry: {len(wynik['data']['parameters'])}")

Referencja pól odpowiedzi

Poziom główny

Obiekt data.metadata

Element tablicy data.parameters

Element tablicy data.interpretation

Pełny przykład odpowiedzi

{
  "status": "success",
  "data": {
    "metadata": {
      "patient_name": "Anna Müller",
      "lab_name": "MedLab Diagnostics International",
      "lab_city": "Warszawa",
      "lab_country": "Polska",
      "lab_date": "2025-12-15",
      "results_date": "2025-12-16",
      "patient_age": "38",
      "patient_sex": "female"
    },
    "parameters": [
      {
        "short_name": "WBC",
        "long_name": "Liczba białych krwinek",
        "category": "Morfologia krwi",
        "result": "6.8",
        "unit": "10^9/L",
        "evaluation": "normal",
        "range_min": "4.0",
        "range_max": "11.0",
        "short_description": "Mierzy całkowitą liczbę białych krwinek.",
        "long_description": "Białe krwinki (leukocyty) są niezbędnymi składnikami układu odpornościowego..."
      },
      {
        "short_name": "RBC",
        "long_name": "Liczba czerwonych krwinek",
        "category": "Morfologia krwi",
        "result": "4.52",
        "unit": "10^12/L",
        "evaluation": "normal",
        "range_min": "3.8",
        "range_max": "5.8",
        "short_description": "Mierzy całkowitą liczbę czerwonych krwinek.",
        "long_description": "Czerwone krwinki (erytrocyty) transportują tlen z płuc do tkanek ciała..."
      },
      {
        "short_name": "HGB",
        "long_name": "Hemoglobina",
        "category": "Morfologia krwi",
        "result": "13.2",
        "unit": "g/dL",
        "evaluation": "normal",
        "range_min": "11.5",
        "range_max": "16.0",
        "short_description": "Białko w czerwonych krwinkach transportujące tlen.",
        "long_description": "Hemoglobina to białko zawierające żelazo w czerwonych krwinkach odpowiedzialne za transport tlenu..."
      },
      {
        "short_name": "GLU",
        "long_name": "Glukoza na czczo",
        "category": "Panel metaboliczny",
        "result": "102",
        "unit": "mg/dL",
        "evaluation": "borderline_high",
        "range_min": "70",
        "range_max": "140",
        "short_description": "Mierzy poziom cukru we krwi na czczo.",
        "long_description": "Glukoza na czczo jest kluczowym wskaźnikiem tego, jak organizm metabolizuje cukier..."
      },
      {
        "short_name": "TC",
        "long_name": "Cholesterol całkowity",
        "category": "Profil lipidowy",
        "result": "218",
        "unit": "mg/dL",
        "evaluation": "borderline_high",
        "range_min": "0",
        "range_max": "300",
        "short_description": "Mierzy całkowity cholesterol we krwi.",
        "long_description": "Cholesterol całkowity to suma cholesterolu HDL, LDL i VLDL..."
      },
      {
        "short_name": "LDL",
        "long_name": "Cholesterol LDL",
        "category": "Profil lipidowy",
        "result": "142",
        "unit": "mg/dL",
        "evaluation": "high",
        "range_min": "0",
        "range_max": "200",
        "short_description": "Mierzy poziom 'złego' cholesterolu.",
        "long_description": "Cholesterol LDL może gromadzić się w ścianach tętnic..."
      }
    ],
    "interpretation": [
      {
        "title": "Ogólna ocena zdrowia",
        "shortcode": "overall_health_assessment",
        "subsections": [
          {
            "subtitle": "Kompleksowy przegląd",
            "items": [
              {"item": "Pacjentka wykazuje ogólnie zdrowe parametry hematologiczne ze wszystkimi wartościami morfologii w normie."},
              {"item": "Profil lipidowy pokazuje obszary wymagające uwagi, szczególnie poziomy cholesterolu LDL."}
            ]
          }
        ]
      },
      {
        "title": "Zalecenia",
        "shortcode": "recommendations",
        "subsections": [
          {
            "subtitle": "Modyfikacje stylu życia",
            "items": [
              {"item": "Zwiększ aktywność fizyczną aerobową do co najmniej 150 minut tygodniowo."},
              {"item": "Przyjmij dietę typu śródziemnomorskiego bogatą w warzywa, owoce i zdrowe tłuszcze."}
            ]
          }
        ]
      }
    ]
  },
  "api_version": "v11",
  "timestamp": "2025-12-16T14:32:18Z"
}

Punkt końcowy produkcyjny z kompleksowym obliczaniem wyniku zdrowia i analizą ryzyka chorób. Przyjmuje takie samo żądanie jak /api/v12/18-09-2026/analyze i dodaje do odpowiedzi poniższe pola. Zużywa 1 kredyt na żądanie.

Przykład cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v12/health-score/analyze" \
  -F "username=TWOJA_NAZWA" \
  -F "password=TWOJE_HASLO" \
  -F "language=pl" \
  -F "file=@badanie_krwi.pdf"

Dodatkowe pola odpowiedzi

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

Generuje kompleksowe rekomendacje żywieniowe i suplementacyjne na podstawie parametrów badań krwi i profilu pacjenta.

Schemat obiektu pacjenta

Szczegółowy opis wszystkich dostępnych pól dla obiektu pacjenta:

Referencja pól odpowiedzi

Obiekt nutrition_plan.educational_insights

Element tablicy blood_marker_education

Element tablicy food_recommendations.power_foods

Element tablicy supplement_recommendations

Kompletny przykład cURL

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

Pełna odpowiedź

{
  "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": "Witamina D",
            "explanation": "Witamina D jest niezbędna dla zdrowia kości, funkcji odpornościowej i regulacji nastroju. Twój poziom 18 ng/mL wskazuje na niedobór, który może wpływać na wchłanianie wapnia i ogólny stan zdrowia.",
            "normal_range": "30-50 ng/mL"
          },
          {
            "marker": "Cholesterol LDL",
            "explanation": "Cholesterol LDL, często nazywany 'złym cholesterolem', może gromadzić się w ścianach tętnic. Twój poziom 140 mg/dL jest podwyższony i może zwiększać ryzyko sercowo-naczyniowe.",
            "normal_range": "< 100 mg/dL"
          }
        ],
        "nutrition_principles": [
          "Priorytet dla kwasów tłuszczowych omega-3 dla zdrowia serca",
          "Zwiększ błonnik rozpuszczalny aby obniżyć cholesterol LDL",
          "Uwzględnij produkty bogate w witaminę D i ekspozycję na słońce"
        ]
      }
    },
    "food_recommendations": {
      "power_foods": [
        {
          "food": "Łosoś dziki",
          "nutrients": ["Omega-3", "Witamina D", "Białko"],
          "serving": "150g, 3 razy w tygodniu",
          "why": "Doskonałe źródło omega-3 i naturalnej witaminy D dla zdrowia serca i kości"
        },
        {
          "food": "Płatki owsiane",
          "nutrients": ["Beta-glukan", "Błonnik", "Magnez"],
          "serving": "50g dziennie na śniadanie",
          "why": "Błonnik rozpuszczalny w owsiance pomaga zmniejszyć wchłanianie cholesterolu LDL"
        },
        {
          "food": "Oliwa z oliwek extra virgin",
          "nutrients": ["Tłuszcze jednonienasycone", "Polifenole", "Witamina E"],
          "serving": "2-3 łyżki stołowe dziennie",
          "why": "Zdrowe tłuszcze śródziemnomorskie poprawiają profil lipidowy i chronią serce"
        },
        {
          "food": "Szpinak",
          "nutrients": ["Żelazo", "Kwas foliowy", "Witamina K"],
          "serving": "100g dziennie, surowy lub gotowany",
          "why": "Bogaty w żelazo i antyoksydanty dla energii i zdrowia sercowo-naczyniowego"
        }
      ]
    },
    "supplement_recommendations": [
      {
        "supplement": "Witamina D3",
        "dosage": "2000-4000 IU dziennie",
        "timing": "Ze śniadaniem (posiłek z tłuszczami)",
        "duration": "3-6 miesięcy, potem powtórne badanie",
        "reason": "Twój poziom 18 ng/mL jest poniżej optymalnego 30-50 ng/mL"
      },
      {
        "supplement": "Omega-3 (EPA/DHA)",
        "dosage": "1000-2000mg EPA+DHA dziennie",
        "timing": "Z głównymi posiłkami",
        "duration": "Stale dla zdrowia serca",
        "reason": "Pomaga obniżyć trójglicerydy i poprawić stosunek HDL/LDL"
      },
      {
        "supplement": "Koenzym Q10",
        "dosage": "100mg dziennie",
        "timing": "Z porannym posiłkiem",
        "duration": "Minimum 3 miesiące",
        "reason": "Wspiera zdrowie serca, szczególnie ważne przy nadciśnieniu"
      }
    ]
  },
  "api_version": "v1",
  "timestamp": "2025-12-22T10:30:00Z"
}

Analizuje trendy w wielu badaniach krwi, dostarczając wizualizacje danych, analizę statystyczną i interpretacje AI zmian parametrów w czasie.

Parametry Żądania

Obiekt analysis_options

Struktura Tablicy blood_tests

Każdy obiekt w tablicy blood_tests powinien zawierać:

Struktura blood_tests[].parameters

Referencja Pól Odpowiedzi

Poziom Główny

Obiekt data.summary

Element Tablicy data.trends

Element Tablicy data.chart_data

Przykład cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/analytics/trends/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "twoja_nazwa_uzytkownika",
    "password": "twoje_haslo",
    "language": "pl",
    "analysis_type": "comprehensive",
    "analysis_options": {
      "include_predictions": true,
      "include_statistics": true,
      "include_charts": true
    },
    "blood_tests": [
      {
        "test_date": "2024-01-15",
        "parameters": [
          {"short_name": "GLU", "result": 115, "unit": "mg/dL"},
          {"short_name": "HBA1C", "result": 6.5, "unit": "%"},
          {"short_name": "CHOL", "result": 240, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 160, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 40, "unit": "mg/dL"}
        ]
      },
      {
        "test_date": "2024-04-22",
        "parameters": [
          {"short_name": "GLU", "result": 108, "unit": "mg/dL"},
          {"short_name": "HBA1C", "result": 6.2, "unit": "%"},
          {"short_name": "CHOL", "result": 220, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 145, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 43, "unit": "mg/dL"}
        ]
      },
      {
        "test_date": "2024-08-15",
        "parameters": [
          {"short_name": "GLU", "result": 102, "unit": "mg/dL"},
          {"short_name": "HBA1C", "result": 5.9, "unit": "%"},
          {"short_name": "CHOL", "result": 205, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 130, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 46, "unit": "mg/dL"}
        ]
      },
      {
        "test_date": "2024-12-18",
        "parameters": [
          {"short_name": "GLU", "result": 95, "unit": "mg/dL"},
          {"short_name": "HBA1C", "result": 5.6, "unit": "%"},
          {"short_name": "CHOL", "result": 190, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 115, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 50, "unit": "mg/dL"}
        ]
      }
    ]
  }'

Przykładowa Odpowiedź

{
  "status": "success",
  "data": {
    "summary": {
      "total_tests": 3,
      "date_range": {
        "earliest": "2025-01-15",
        "latest": "2025-12-15"
      },
      "parameters_tracked": 3
    },
    "trends": [
      {
        "parameter_name": "Cholesterol całkowity",
        "short_name": "CHOL",
        "trend_direction": "downward",
        "trend_strength": "moderate",
        "statistical_significance": true,
        "percent_change": -13.6,
        "chart_data": [
          {"date": "2025-01-15", "value": 220, "unit": "mg/dL", "evaluation": "borderline_high"},
          {"date": "2025-06-15", "value": 205, "unit": "mg/dL", "evaluation": "borderline_high"},
          {"date": "2025-12-15", "value": 190, "unit": "mg/dL", "evaluation": "normal"}
        ],
        "interpretation": "Pozytywny trend spadkowy cholesterolu całkowitego o 13.6% w ciągu roku. Wartości poprawiły się z granicznych do normalnych zakresów."
      }
    ],
    "overall_interpretation": {
      "title": "Ogólna Ocena Trendów",
      "content": "Twoje wyniki badań pokazują pozytywny trend poprawy profilu lipidowego w ciągu ostatniego roku. Cholesterol całkowity i LDL wykazują konsekwentny spadek, podczas gdy HDL pokazuje korzystną tendencję wzrostową."
    }
  },
  "api_version": "v1",
  "timestamp": "2025-12-22T10:30:00Z"
}

Porównuje wiele badań krwi i generuje szczegółowe narracyjne spostrzeżenia AI na temat zmian parametrów, trendów i znaczenia klinicznego różnic.

Parametry Żądania

Struktura Tablicy blood_tests

Każdy obiekt w tablicy blood_tests powinien zawierać:

Referencja Pól Odpowiedzi

Poziom Główny

Obiekt data.summary

Element Tablicy data.comparisons

Element Tablicy changes

Przykład cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/bloodtest/comparison/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "twoja_nazwa_uzytkownika",
    "password": "twoje_haslo",
    "language": "pl",
    "blood_tests": [
      {
        "test_date": "2025-01-15",
        "parameters": [
          {"short_name": "HBA1C", "result": 6.8, "unit": "%"},
          {"short_name": "GLU", "result": 115, "unit": "mg/dL"},
          {"short_name": "CHOL", "result": 220, "unit": "mg/dL"}
        ]
      },
      {
        "test_date": "2025-07-15",
        "parameters": [
          {"short_name": "HBA1C", "result": 6.2, "unit": "%"},
          {"short_name": "GLU", "result": 98, "unit": "mg/dL"},
          {"short_name": "CHOL", "result": 195, "unit": "mg/dL"}
        ]
      }
    ],
    "patient": {
      "age": 52,
      "gender": "female"
    }
  }'

Przykładowa Odpowiedź

{
  "status": "success",
  "data": {
    "summary": {
      "total_tests": 2,
      "date_range": {
        "earliest": "2025-01-15",
        "latest": "2025-07-15"
      },
      "overall_trend": "improving",
      "time_span_days": 181
    },
    "comparisons": [
      {
        "parameter_name": "Hemoglobina glikowana (HbA1c)",
        "short_name": "HBA1C",
        "changes": [
          {
            "from_date": "2025-01-15",
            "to_date": "2025-07-15",
            "from_value": 6.8,
            "to_value": 6.2,
            "change_amount": -0.6,
            "change_percent": -8.8,
            "trend_assessment": "positive"
          }
        ],
        "narrative_summary": "Twój poziom HbA1c uległ znacznej poprawie, spadając z 6.8% do 6.2% w ciągu 6 miesięcy - spadek o 8.8%. To reprezentuje zmniejszenie średniego poziomu glukozy we krwi.",
        "clinical_significance": "Ta poprawa jest klinicznie istotna i pokazuje lepszą kontrolę glukozy. Utrzymanie tych poziomów znacząco zmniejsza ryzyko komplikacji związanych z cukrzycą."
      },
      {
        "parameter_name": "Glukoza",
        "short_name": "GLU",
        "changes": [
          {
            "from_date": "2025-01-15",
            "to_date": "2025-07-15",
            "from_value": 115,
            "to_value": 98,
            "change_amount": -17,
            "change_percent": -14.8,
            "trend_assessment": "positive"
          }
        ],
        "narrative_summary": "Glukoza na czczo spadła z 115 mg/dL (przedcukrzyca) do 98 mg/dL (normalny zakres), odzwierciedlając poprawę o 14.8% w kontroli glukozy.",
        "clinical_significance": "Ten spadek przenosi Cię z zakresu przedcukrzycy do normalnych poziomów glukozy, znacząco zmniejszając ryzyko rozwoju cukrzycy typu 2."
      }
    ],
    "overall_interpretation": {
      "title": "Ogólna Ocena Porównania",
      "content": "Twoje wyniki badań pokazują doskonałą poprawę w kontroli glukozy i zarządzaniu ryzykiem metabolicznym. Wszystkie kluczowe parametry związane z metabolizmem glukozy wykazują pozytywne trendy. Twoje zmiany w stylu życia przynoszą wyraźne korzyści."
    },
    "recommendations": {
      "title": "Zalecenia do Kontynuacji",
      "items": [
        "Kontynuuj obecny plan żywieniowy i aktywność fizyczną",
        "Rozważ monitorowanie HbA1c co 3 miesiące",
        "Utrzymuj dziennik poziomów glukozy we krwi"
      ]
    }
  },
  "api_version": "v1",
  "timestamp": "2025-12-22T10:30:00Z"
}

Sprawdź pozostały limit API. Wymagane uwierzytelnianie.

Przykład cURL

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

Przykładowa Odpowiedź

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

Generuj kompleksowy raport oceny ryzyka zdrowia rodzinnego napędzany AI.

Parametry żądania (JSON Body)

Przykład cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/family-health/analyze" \
  -H "Content-Type: application/json" \
  -d '{"username":"UŻYTKOWNIK","password":"HASŁO","patient_data":{"name":"Anna Kowalska","age":42,"gender":"female"},"family_members":[{"relation":"father","age":70,"conditions":["hypertension"]}],"language":"pl"}'

Przykład Python

import requests
url = "https://app.aibloodtestinterpret.com/api/v1/family-health/analyze"
payload = {"username":"UŻYTKOWNIK","password":"HASŁO","patient_data":{"name":"Anna Kowalska","age":42,"gender":"female"},"family_members":[{"relation":"father","age":70,"conditions":["hypertension"]}],"language":"pl"}
response = requests.post(url, json=payload, timeout=120)
print(response.json())

Przykładowa odpowiedź

{"status":"success","data":{"report_data":{"report_title":"Raport Oceny Ryzyka Zdrowia Rodzinnego","hereditary_risk_analysis":{"high_risk":[{"condition":"Choroba sercowo-naczyniowa","risk_score":75}]},"genetic_screening_recommendations":["Test genetyczny BRCA1/BRCA2"]}},"timestamp":"2026-03-23T10:30:00Z","api_version":"1.0.0"}

Kody błędów Family Health API

Umieszcza każdy oznaczony wynik z panelu laboratoryjnego na ciele. Zużywa 1 kredyt na każde udane żądanie. Żądanie, które nie przejdzie walidacji lub którego oznaczonych markerów nie da się umiejscowić, nie jest rozliczane.

Parametry żądania

Pola obiektu parametru

Przykład cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/body-map/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "TWOJA_NAZWA",
    "password": "TWOJE_HASLO",
    "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"}
    ]
  }'

Przykład Python

import requests

def build_body_map(parameters, username: str, password: str, include_image: bool = False):
    """
    Umieszcza wyniki badań krwi poza zakresem na mapie ciała.
    Domyślnie tryb deterministyczny — bez wywołania modelu.
    """
    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()

result = build_body_map(
    parameters=[
        {"short_name": "ALT", "result": "65", "unit": "U/L",
         "range_normal_min": 7, "range_normal_max": 45, "evaluation": "high"},
        {"short_name": "TSH", "result": "6.2", "unit": "mIU/L",
         "range_normal_min": 0.4, "range_normal_max": 4.0, "evaluation": "high"},
    ],
    username="uzytkownik",
    password="haslo",
)

body_map = result["data"]["body_map"]
if result["data"]["all_clear"]:
    print("Bez odchyleń — nic nie zostało oznaczone.")
for region in body_map["regions"]:
    nasilenie = "poza zakresem" if region["level"] == 2 else "graniczny"
    print(f"  {region['key']}: {nasilenie} ({', '.join(region['markers'])})")
print(f"Ilustracja: {body_map['image_url'] or body_map['fallback_url']}")

Przykładowa odpowiedź

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

Referencja pól odpowiedzi

Sprawdza dane żądania bez uruchamiania analizy i zgłasza, które z Twoich nazw analitów silnik rozpoznaje. Uwierzytelnienie jest wymagane; limit nie jest zużywany, a punkt końcowy działa również na koncie bez pozostałych kredytów.

Przykład cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/body-map/validate" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "TWOJA_NAZWA",
    "password": "TWOJE_HASLO",
    "parameters": [
      {"short_name": "ALT", "result": "65", "evaluation": "high"},
      {"short_name": "Unobtainium", "result": "9", "evaluation": "high"}
    ]
  }'

Przykładowa odpowiedź

{
  "status": "success",
  "api_version": "1.0.0",
  "message": "Payload is valid",
  "data": {
    "valid": true,
    "errors": [],
    "parameter_count": 2,
    "flagged_count": 2,
    "recognised": [
      {"name": "ALT", "region": "liver", "level": 2}
    ],
    "unrecognised": [
      {"name": "Unobtainium", "region": null, "level": 2}
    ]
  },
  "timestamp": "2026-09-18T10:30:00Z"
}

Wymienia 13 obszarów ciała w kanonicznej kolejności wraz z poziomami nasilenia. Użyj go, aby zbudować własne tłumaczenia legendy.

Przykład cURL

curl "https://app.aibloodtestinterpret.com/api/v1/body-map/regions"

Przykładowa odpowiedź

{
  "status": "success",
  "data": {
    "regions": [
      {"key": "brain_nerves", "code": "brn", "order": 0},
      {"key": "thyroid", "code": "thy", "order": 1},
      {"key": "heart_vessels", "code": "hrt", "order": 2},
      {"key": "liver", "code": "liv", "order": 3}
    ],
    "region_keys": ["brain_nerves", "thyroid", "heart_vessels", "liver", "pancreas", "adrenals", "kidneys", "gut", "reproductive", "blood", "immune", "bones", "muscles"],
    "levels": {
      "0": "within range — not shown",
      "1": "borderline (slightly high / slightly low)",
      "2": "out of range (high / low / abnormal)"
    },
    "count": 13
  }
}

Metadane możliwości: czy silnik jest włączony w tym wdrożeniu, limity żądań, schemat uwierzytelniania i pełna lista endpointów.

Przykład cURL

curl "https://app.aibloodtestinterpret.com/api/v1/body-map/info"

Oblicza biologiczny wiek krwi oraz wskaźniki pochodne na podstawie panelu laboratoryjnego. Zużywa 1 kredyt na każde udane żądanie. Żądanie, które nie przejdzie walidacji lub którego panel nie pozwala nic obliczyć, nie jest rozliczane.

Parametry żądania

Dziewięć markerów PhenoAge

Wysyłaj je pod takimi nazwami, jakie wydrukowało Twoje laboratorium — dopasowanie odbywa się po nazwie, w dowolnym z 39 obsługiwanych języków raportów, a jednostki są przeliczane automatycznie.

Przykład cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/blood-age/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "TWOJA_NAZWA",
    "password": "TWOJE_HASLO",
    "metadata": {"patient_age": "40", "patient_sex": "Male", "lab_date": "2026-09-11"},
    "parameters": [
      {"short_name": "Albumin", "result": 4.4, "unit": "g/dL", "range_normal_min": 3.5, "range_normal_max": 5.0},
      {"short_name": "Creatinine", "result": 0.9, "unit": "mg/dL", "range_normal_min": 0.6, "range_normal_max": 1.2},
      {"short_name": "Glucose", "result": 90, "unit": "mg/dL", "range_normal_min": 70, "range_normal_max": 99},
      {"short_name": "CRP", "result": 1.0, "unit": "mg/L", "range_normal_min": 0, "range_normal_max": 5},
      {"short_name": "Lymphocytes", "result": 30, "unit": "%", "range_normal_min": 20, "range_normal_max": 40},
      {"short_name": "MCV", "result": 90, "unit": "fL", "range_normal_min": 80, "range_normal_max": 100},
      {"short_name": "RDW", "result": 13, "unit": "%", "range_normal_min": 11.5, "range_normal_max": 14.5},
      {"short_name": "ALP", "result": 70, "unit": "U/L", "range_normal_min": 40, "range_normal_max": 130},
      {"short_name": "WBC", "result": 6.0, "unit": "10^9/L", "range_normal_min": 4, "range_normal_max": 11}
    ]
  }'

Przykład Python

import requests

def biological_blood_age(parameters, metadata, username: str, password: str):
    """
    Oblicza biologiczny wiek krwi na podstawie zwykłego panelu krwi.
    Nagłówek metadata powinien zawierać patient_age i patient_sex.
    """
    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()

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="uzytkownik",
    password="haslo",
)

summary = result["data"]["summary"]
if summary["status"] != "ok":
    print(f"Nie obliczono wieku: {summary['status']}")
else:
    print(f"Wiek metrykalny: {summary['chronological_age']}")
    print(f"Wiek biologiczny: {summary['biological_age']} ({summary['source']})")
    print(f"Różnica:          {summary['delta_years']:+} lat")

for index in result["data"]["blood_age"]["indices"]:
    print(f"  {index['key']}: {index['value']} {index['unit']} [{index['band']}]")

Przykładowa odpowiedź

{
  "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": [],
        "labels": {"albumin": "Albumin", "creatinine": "Creatinine", "glucose": "Glucose"},
        "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"
}

Referencja pól odpowiedzi

Sprawdza dane żądania bez uruchamiania analizy i zgłasza, które z dziewięciu markerów PhenoAge zawiera Twój panel oraz czy udało się odczytać wiek metrykalny — czyli dwie rzeczy rozstrzygające, czy otrzymasz pełny wzór, czy oszacowanie częściowe. Uwierzytelnienie jest wymagane; limit nie jest zużywany, a punkt końcowy działa również na koncie bez pozostałych kredytów.

Przykład cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/blood-age/validate" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "TWOJA_NAZWA",
    "password": "TWOJE_HASLO",
    "metadata": {"patient_age": "40", "patient_sex": "Male"},
    "parameters": [
      {"short_name": "MCV", "result": 90, "unit": "fL"},
      {"short_name": "WBC", "result": 6.0, "unit": "10^9/L"},
      {"short_name": "Lymphocytes", "result": 30, "unit": "%"}
    ]
  }'

Przykładowa odpowiedź

{
  "status": "success",
  "api_version": "1.0.0",
  "message": "Payload is valid",
  "data": {
    "valid": true,
    "errors": [],
    "parameter_count": 3,
    "looks_like_blood_panel": true,
    "chronological_age": 40,
    "sex": "m",
    "phenoage_markers_found": ["lymph", "mcv", "wbc"],
    "phenoage_markers_missing": ["albumin", "creatinine", "glucose", "crp", "rdw", "alp"],
    "expected_source": "partial",
    "recognised_markers": ["lymph_pct", "mcv", "wbc"]
  },
  "timestamp": "2026-09-18T10:30:00Z"
}

Wymienia dziewięć danych wejściowych PhenoAge, każdy marker, który silnik potrafi odczytać, wraz z jednostką docelową, oraz zakres wieku, dla którego obowiązuje wzór.

Przykład cURL

curl "https://app.aibloodtestinterpret.com/api/v1/blood-age/biomarkers"

Przykładowa odpowiedź

{
  "status": "success",
  "data": {
    "phenoage_inputs": ["albumin", "creatinine", "glucose", "crp", "lymph", "mcv", "rdw", "alp", "wbc"],
    "phenoage_age_range": {"min": 18, "max": 100},
    "markers": [
      {"key": "albumin", "target_unit": "g/l"},
      {"key": "alp", "target_unit": "u/l"},
      {"key": "alt", "target_unit": "u/l"}
    ],
    "marker_count": 33,
    "name_matching": "Markers are matched by the analyte name your laboratory printed, in any of the supported report languages. You never send these keys."
  }
}

Metadane możliwości: czy silnik jest włączony w tym wdrożeniu, dwa tryby i koszt każdego z nich, limity żądań, schemat uwierzytelniania i obsługiwane języki.

Przykład cURL

curl "https://app.aibloodtestinterpret.com/api/v1/blood-age/info"

Interpretuje jeden test DNA i zwraca kompleksowy raport zdrowia genetycznego. Wyślij plik jako multipart/form-data albo wklejone wiersze genotypu jako JSON. Przesłany plik jest przetwarzany od razu, więc na nieczytelny plik API natychmiast odpowiada kodem 400 i niczego nie pobiera. Jeden kredyt jest pobierany dopiero po wygenerowaniu raportu.

Parametry żądania

Przykład cURL

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

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

Przykład Python

import time
import requests

BASE = "https://app.aibloodtestinterpret.com"
AUTH = ("TWOJA_NAZWA", "TWOJE_HASLO")


def run(path, poll=True, **kwargs):
    """Wysyła POST w trybie asynchronicznym i odpytuje /api/jobs/<id>, aż raport będzie gotowy."""
    resp = requests.post(f"{BASE}{path}?async=1", auth=AUTH, timeout=60, **kwargs)
    body = resp.json()
    if resp.status_code != 202:
        return body                      # błąd lub odpowiedź synchroniczna
    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) Interpretacja testu DNA
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"])

Przykładowa odpowiedź

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

Referencja pól odpowiedzi

Przetwarza przesłany plik dokładnie tak jak /analyze i zgłasza, co zostało znalezione, bez wywołania AI. Uwierzytelnienie jest wymagane; kredyt nie jest zużywany. Użyj go, aby sprawdzić plik, zanim wykorzystasz kredyt.

Przykładowa odpowiedź

{
  "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": []}
  }
}

Łączy raport DNA ze zinterpretowanym badaniem krwi w jeden raport zdrowotny. Każde powiązanie między ustaleniem genetycznym a wartością laboratoryjną zostaje sklasyfikowane, a raport uzupełniają macierz ryzyka, działania priorytetowe i plan monitorowania. Jeden kredyt za każde udane żądanie.

Parametry żądania

Przykład Python

# 2) Raport zdrowotny DNA + krew (korzysta z run() i dna z przykładu powyżej)
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"])

Przykładowa odpowiedź

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

Referencja pól odpowiedzi

Tworzy spersonalizowany plan suplementacji na podstawie raportu DNA, odpowiedzi z kwestionariusza i opcjonalnie zinterpretowanego badania krwi. Katalog produktów Twojej kliniki i ustawienia doradcy są stosowane automatycznie. Jeden kredyt za każde udane żądanie.

Parametry żądania

Przykład cURL

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

Przykład Python

# 3) Plan suplementacji (korzysta z run(), dna i blood_test z przykładów powyżej)
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"])

Przykładowa odpowiedź

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

Referencja pól odpowiedzi

Odczytuje lub aktualizuje katalog produktów Twojej kliniki i ustawienia doradcy. To ten sam katalog co w panelu kliniki i w AI Żywienie, więc produkt dodany w jednym miejscu jest dostępny wszędzie. Uwierzytelnienie jest wymagane; kredyt nie jest zużywany. Wyślij catalogue, settings lub oba; katalog zastępuje całą dotychczasową listę.

Przykład cURL

curl -X PUT "https://app.aibloodtestinterpret.com/api/v1/dna-supplements/settings" \
  -u "TWOJA_NAZWA:TWOJE_HASLO" \
  -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}
  }'

Ekstrahuje całą zawartość tekstową z przesłanych dokumentów za pomocą technologii ICR Kantesti.

Parametry Żądania

Przykład cURL

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

Przykład Python

import requests

def icr_extract(file_path: str, username: str, password: str, language: str = "pl"):
    """
    Wyodrębnij tekst z dokumentu za pomocą API ICR Kantesti.
    79% szybszy i dokładniejszy niż tradycyjne 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("raport_medyczny.pdf", "uzytkownik", "haslo", "pl")
print(f"Typ dokumentu: {result['data']['document_type']}")
print(f"Strony: {result['data']['page_count']}")

Przykładowa Odpowiedź

{
  "status": "success",
  "data": {
    "document_type": "blood_test_report",
    "page_count": 1,
    "pages": [{"page_number": 1, "content": {"raw_text": "Szpital Uniwersytecki w Kolonii - Morfologia...", "sections": [{"type": "header", "content": "Morfologia"}], "tables": [{"headers": ["Test", "Wynik", "Jednostka", "Zakres Referencyjny"], "rows": [["Glukoza", "92", "mg/dL", "74 - 100"], ["ALT", "22", "U/L", "< 35"]]}]}}],
    "metadata": {"detected_language": "pl", "confidence": "high"},
    "icr_metadata": {"engine": "kantesti-icr", "version": "1.0.0"}
  },
  "credit_cost": 0.5,
  "api_version": "icr-v1"
}