נקודות קצה API

נקודת קצה ייצור לניתוח דם. צורכת קרדיט אחד לכל בקשה.

פרמטרי בקשה

דוגמה cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze" \
  -F "username=YOUR_USERNAME" \
  -F "password=YOUR_PASSWORD" \
  -F "language=he" \
  -F "file=@blood_test.pdf"

דוגמה Python

import requests

def analyze_blood_test(file_path: str, username: str, password: str, language: str = "he"):
    """
    נתח קובץ בדיקת דם עם Kantesti API.

    Args:
        file_path: נתיב ל-PDF או תמונת בדיקת הדם
        username: שם משתמש API
        password: סיסמת API
        language: קוד שפת תגובה (ברירת מחדל: he)

    Returns:
        dict: תגובת API עם תוצאות ניתוח
    """
    url = "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze"

    with open(file_path, "rb") as f:
        files = {"file": (file_path, f, "application/pdf")}
        data = {
            "username": username,
            "password": password,
            "language": language
        }

        response = requests.post(url, files=files, data=data, timeout=120)
        response.raise_for_status()
        return response.json()

# דוגמה לשימוש
if __name__ == "__main__":
    result = analyze_blood_test(
        file_path="blood_test.pdf",
        username="your_username",
        password="your_password",
        language="he"
    )
    print(f"סטטוס: {result['status']}")
    print(f"פרמטרים שנמצאו: {len(result['data']['parameters'])}")

דוגמה לתגובה

{
  "status": "success",
  "data": {
    "metadata": {
      "patient_name": "Jan Novák",
      "lab_name": "מרכז רפואי BioLAB",
      "lab_city": "תל אביב",
      "lab_country": "ישראל",
      "lab_date": "2025-05-11",
      "patient_age": "45",
      "patient_sex": "זכר"
    },
    "parameters": [
      {
        "short_name": "WBC",
        "long_name": "תאי דם לבנים",
        "category": "ספירת דם מלאה",
        "result": 7.2,
        "unit": "10^9/L",
        "evaluation": "תקין",
        "range_min": 2.0,
        "range_max": 12.0,
        "range_normal_min": 4.0,
        "range_normal_max": 10.0,
        "short_description": "מודד את המספר הכולל של תאי דם לבנים בדם.",
        "long_description": "תאי דם לבנים (לויקוציטים) חיוניים לתפקוד מערכת החיסון..."
      }
    ],
    "interpretation": [
      {
        "title": "הערכת בריאות כללית",
        "shortcode": "overall_health_assessment",
        "subsections": [...]
      }
    ]
  },
  "api_version": "v11",
  "timestamp": "2025-12-22T10:30:00Z"
}

הפניית שדות תגובה

רמה שורשית

אובייקט data.metadata

אלמנט מערך data.parameters

אלמנט מערך data.interpretation

מייצר המלצות מקיפות לתזונה ותוספים על סמך פרמטרי בדיקת דם ופרופיל המטופל.

סכמת אובייקט מטופל

תיאור מפורט של כל השדות הזמינים עבור אובייקט המטופל:

הפניית שדות תגובה

אובייקט nutrition_plan.educational_insights

אלמנט מערך blood_marker_education

אלמנט מערך food_recommendations.power_foods

אלמנט מערך supplement_recommendations

דוגמת cURL מלאה

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/nutrition/diet-plan/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "שם_המשתמש_שלך",
    "password": "הסיסמה_שלך",
    "language": "he",
    "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"]
  }'

תגובה מלאה

{
  "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": "ויטמין D",
            "explanation": "ויטמין D חיוני לבריאות העצמות, תפקוד מערכת החיסון וויסות מצב הרוח. הרמה שלך של 18 ng/mL מצביעה על מחסור שעלול להשפיע על ספיגת סידן ועל הבריאות הכללית.",
            "normal_range": "30-50 ng/mL"
          },
          {
            "marker": "כולסטרול LDL",
            "explanation": "כולסטרול LDL, המכונה לעתים 'כולסטרול רע', יכול להצטבר בדפנות העורקים. הרמה שלך של 140 מ\"ג/דל גבוהה ועלולה להגביר את הסיכון הקרדיווסקולרי.",
            "normal_range": "< 100 mg/dL"
          }
        ],
        "nutrition_principles": [
          "תעדוף חומצות שומן אומגה-3 לבריאות הלב",
          "הגדל סיבים מסיסים להורדת כולסטרול LDL",
          "שלב מזונות עשירים בויטמין D וחשיפה לשמש"
        ]
      }
    },
    "food_recommendations": {
      "power_foods": [
        {
          "food": "סלמון בר",
          "nutrients": ["אומגה-3", "ויטמין D", "חלבון"],
          "serving": "150 גרם, 3 פעמים בשבוע",
          "why": "מקור מצוין לאומגה-3 ולויטמין D טבעי לבריאות הלב והעצמות"
        },
        {
          "food": "שיבולת שועל מלאה",
          "nutrients": ["בטא-גלוקן", "סיבים", "מגנזיום"],
          "serving": "50 גרם ביום בארוחת הבוקר",
          "why": "סיבים מסיסים בשיבולת שועל עוזרים להפחית את ספיגת כולסטרול LDL"
        },
        {
          "food": "שמן זית כתית מעולה",
          "nutrients": ["שומנים חד-בלתי רוויים", "פוליפנולים", "ויטמין E"],
          "serving": "2-3 כפות ביום",
          "why": "שומנים בריאים ים-תיכוניים משפרים את פרופיל השומנים ומגנים על הלב"
        },
        {
          "food": "תרד",
          "nutrients": ["ברזל", "חומצה פולית", "ויטמין K"],
          "serving": "100 גרם ביום, נא או מבושל",
          "why": "עשיר בברזל ונוגדי חמצון לאנרגיה ולבריאות קרדיווסקולרית"
        }
      ]
    },
    "supplement_recommendations": [
      {
        "supplement": "ויטמין D3",
        "dosage": "2000-4000 יח\"ב ביום",
        "timing": "עם ארוחת הבוקר (ארוחה עם שומנים)",
        "duration": "3-6 חודשים, לאחר מכן בדיקה מחדש",
        "reason": "הרמה שלך של 18 ng/mL נמוכה מהאופטימום של 30-50 ng/mL"
      },
      {
        "supplement": "אומגה-3 (EPA/DHA)",
        "dosage": "1000-2000 מ\"ג EPA+DHA ביום",
        "timing": "עם הארוחות העיקריות",
        "duration": "באופן מתמשך לבריאות הלב",
        "reason": "עוזר להוריד טריגליצרידים ולשפר את יחס HDL/LDL"
      },
      {
        "supplement": "קו-אנזים Q10",
        "dosage": "100 מ\"ג ביום",
        "timing": "עם ארוחת הבוקר",
        "duration": "מינימום 3 חודשים",
        "reason": "תומך בבריאות הלב, חשוב במיוחד עם לחץ דם גבוה"
      }
    ]
  },
  "api_version": "v1",
  "timestamp": "2025-12-22T10:30:00Z"
}

נתח עד 50 בדיקות דם כדי לזהות מגמות, דפוסים וחריגות בפרמטרי בריאות לאורך זמן.

פרמטרי בקשה

אובייקט analysis_options

תצורת אפשרויות הניתוח האופציונלית מאפשרת לך לשלוט על איזה רכיבי ניתוח נכללים בתגובה:

מבנה מערך blood_tests

כל אלמנט במערך blood_tests חייב להיות אובייקט בפורמט הבא:

מבנה blood_tests[].parameters

כל פרמטר במערך parameters חייב להכיל את השדות הבאים:

דוגמה cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/analytics/trends/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "שם_המשתמש_שלך",
    "password": "הסיסמה_שלך",
    "language": "he",
    "analysis_type": "comprehensive",
    "analysis_options": {
      "include_predictions": true,
      "include_statistics": true,
      "include_charts": true
    },
    "blood_tests": [
      {
        "date": "2025-01-15",
        "parameters": [
          {"short_name": "Glucose", "result": 145, "unit": "mg/dL", "range_min": 70, "range_max": 100},
          {"short_name": "HbA1c", "result": 7.2, "unit": "%", "range_min": 4.0, "range_max": 6.0},
          {"short_name": "CHOL", "result": 240, "unit": "mg/dL", "range_min": 0, "range_max": 200},
          {"short_name": "LDL", "result": 160, "unit": "mg/dL", "range_min": 0, "range_max": 100},
          {"short_name": "HDL", "result": 38, "unit": "mg/dL", "range_min": 40, "range_max": 60}
        ]
      },
      {
        "date": "2025-04-20",
        "parameters": [
          {"short_name": "Glucose", "result": 125, "unit": "mg/dL", "range_min": 70, "range_max": 100},
          {"short_name": "HbA1c", "result": 6.5, "unit": "%", "range_min": 4.0, "range_max": 6.0},
          {"short_name": "CHOL", "result": 220, "unit": "mg/dL", "range_min": 0, "range_max": 200},
          {"short_name": "LDL", "result": 140, "unit": "mg/dL", "range_min": 0, "range_max": 100},
          {"short_name": "HDL", "result": 42, "unit": "mg/dL", "range_min": 40, "range_max": 60}
        ]
      },
      {
        "date": "2025-07-18",
        "parameters": [
          {"short_name": "Glucose", "result": 110, "unit": "mg/dL", "range_min": 70, "range_max": 100},
          {"short_name": "HbA1c", "result": 6.0, "unit": "%", "range_min": 4.0, "range_max": 6.0},
          {"short_name": "CHOL", "result": 200, "unit": "mg/dL", "range_min": 0, "range_max": 200},
          {"short_name": "LDL", "result": 120, "unit": "mg/dL", "range_min": 0, "range_max": 100},
          {"short_name": "HDL", "result": 48, "unit": "mg/dL", "range_min": 40, "range_max": 60}
        ]
      },
      {
        "date": "2025-12-10",
        "parameters": [
          {"short_name": "Glucose", "result": 95, "unit": "mg/dL", "range_min": 70, "range_max": 100},
          {"short_name": "HbA1c", "result": 5.4, "unit": "%", "range_min": 4.0, "range_max": 6.0},
          {"short_name": "CHOL", "result": 180, "unit": "mg/dL", "range_min": 0, "range_max": 200},
          {"short_name": "LDL", "result": 95, "unit": "mg/dL", "range_min": 0, "range_max": 100},
          {"short_name": "HDL", "result": 52, "unit": "mg/dL", "range_min": 40, "range_max": 60}
        ]
      }
    ]
  }'

הפניית שדות תגובה

רמה שורשית

אובייקט data.trend_analysis

אלמנט מערך data.trend_analysis.trends

אובייקט data.insights

צור השוואה נרטיבית מונעת AI בין מספר בדיקות דם, תוך הדגשת שינויים מרכזיים והשלכות בריאותיות.

פרמטרי בקשה

מבנה מערך blood_tests

כל אלמנט במערך blood_tests חייב להיות אובייקט בפורמט הבא:

מבנה אלמנט parameters

דוגמה cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/bloodtest/comparison/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "שם_המשתמש_שלך",
    "password": "הסיסמה_שלך",
    "language": "he",
    "blood_tests": [
      {
        "date": "2025-06-01",
        "label": "לפני טיפול",
        "parameters": [
          {"short_name": "CHOL", "result": 240, "unit": "mg/dL", "range_min": 0, "range_max": 200},
          {"short_name": "LDL", "result": 160, "unit": "mg/dL", "range_min": 0, "range_max": 100},
          {"short_name": "HDL", "result": 38, "unit": "mg/dL", "range_min": 40, "range_max": 60}
        ]
      },
      {
        "date": "2025-09-15",
        "label": "אחרי 3 חודשים",
        "parameters": [
          {"short_name": "CHOL", "result": 195, "unit": "mg/dL", "range_min": 0, "range_max": 200},
          {"short_name": "LDL", "result": 115, "unit": "mg/dL", "range_min": 0, "range_max": 100},
          {"short_name": "HDL", "result": 45, "unit": "mg/dL", "range_min": 40, "range_max": 60}
        ]
      }
    ]
  }'

הפניית שדות תגובה

רמה שורשית

אובייקט data.comparison

אלמנט מערך data.comparison.changes

אובייקט data.narrative

מחזיר מידע על פלטפורמת ה-API, גרסאות זמינות ותכונות נתמכות. אין צורך באימות.

דוגמה לתגובה

{
  "platform": "Kantesti Blood Test Analysis API",
  "versions": ["v6", "v8", "v9", "v10", "v11"],
  "latest_version": "v11",
  "supported_languages": 100,
  "documentation": "https://www.kantesti.net/docs/",
  "status": "operational"
}

נקודת קצה לבדיקת תקינות לצורך ניטור. מחזירה סטטוס שירות. אין צורך באימות.

דוגמה לתגובה

{
  "status": "healthy",
  "timestamp": "2025-12-22T10:30:00Z",
  "uptime": "99.99%"
}

בדוק את מכסת ה-API הנותרת שלך. נדרש אימות.

דוגמה cURL

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

דוגמה לתגובה

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

הפקת דוח מקיף להערכת סיכוני בריאות משפחתית מונע בינה מלאכותית.

פרמטרי בקשה (JSON Body)

דוגמת cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/family-health/analyze" \
  -H "Content-Type: application/json" \
  -d '{"username":"שם_משתמש","password":"סיסמה","patient_data":{"name":"שרה כהן","age":42,"gender":"female"},"family_members":[{"relation":"father","age":70,"conditions":["hypertension"]}],"language":"he"}'

דוגמת Python

import requests
url = "https://app.aibloodtestinterpret.com/api/v1/family-health/analyze"
payload = {"username":"שם_משתמש","password":"סיסמה","patient_data":{"name":"שרה כהן","age":42,"gender":"female"},"family_members":[{"relation":"father","age":70,"conditions":["hypertension"]}],"language":"he"}
response = requests.post(url, json=payload, timeout=120)
print(response.json())

דוגמת תגובה

{"status":"success","data":{"report_data":{"report_title":"דוח הערכת סיכוני בריאות משפחתית","hereditary_risk_analysis":{"high_risk":[{"condition":"מחלת לב וכלי דם","risk_score":75}]},"genetic_screening_recommendations":["בדיקה גנטית BRCA1/BRCA2"]}},"timestamp":"2026-03-23T10:30:00Z","api_version":"1.0.0"}

קודי שגיאה של Family Health API

מחלץ את כל תוכן הטקסט ממסמכים שהועלו באמצעות טכנולוגיית ICR של Kantesti.

פרמטרי בקשה

דוגמת cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/icr/v1/extract" \
  -F "username=שם_משתמש" \
  -F "password=סיסמה" \
  -F "language=he" \
  -F "[email protected]"

דוגמת Python

import requests

def icr_extract(file_path: str, username: str, password: str, language: str = "he"):
    """
    חילוץ טקסט ממסמך באמצעות ממשק ICR של Kantesti.
    מהיר ב-79% ומדויק יותר מ-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("דוח_רפואי.pdf", "משתמש", "סיסמה", "he")
print(f"סוג מסמך: {result['data']['document_type']}")
print(f"עמודים: {result['data']['page_count']}")

דוגמת תגובה

{
  "status": "success",
  "data": {
    "document_type": "blood_test_report",
    "page_count": 1,
    "pages": [{"page_number": 1, "content": {"raw_text": "בית חולים אוניברסיטאי קלן - בדיקת דם...", "sections": [{"type": "header", "content": "בדיקת דם"}], "tables": [{"headers": ["בדיקה", "תוצאה", "יחידה", "טווח התייחסות"], "rows": [["גלוקוז", "92", "mg/dL", "74 - 100"], ["ALT", "22", "U/L", "< 35"]]}]}}],
    "metadata": {"detected_language": "he", "confidence": "high"},
    "icr_metadata": {"engine": "kantesti-icr", "version": "1.0.0"}
  },
  "credit_cost": 0.5,
  "api_version": "icr-v1"
}