Punkty Końcowe API

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

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

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