نقاط نهاية API

نقطة نهاية الإنتاج لتحليل الدم. يستهلك رصيدًا واحدًا لكل طلب.

معاملات الطلب

مثال cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v11/01-06-2025/analyze" \
  -F "username=اسم_المستخدم" \
  -F "password=كلمة_المرور" \
  -F "language=ar" \
  -F "file=@تحليل_الدم.pdf"

مثال Python

import requests

def analyze_blood_test(file_path: str, username: str, password: str, language: str = "ar"):
    """
    تحليل ملف فحص الدم باستخدام API Kantesti.

    Args:
        file_path: المسار إلى PDF أو صورة فحص الدم
        username: اسم مستخدم API
        password: كلمة مرور API
        language: رمز لغة الاستجابة (افتراضي: ar)

    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="تحليل_الدم.pdf",
        username="اسم_المستخدم",
        password="كلمة_المرور",
        language="ar"
    )
    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": "خلايا الدم البيضاء (الكريات البيض) ضرورية لوظيفة المناعة..."
      },
      {
        "short_name": "HGB",
        "long_name": "الهيموجلوبين",
        "category": "تعداد الدم الكامل",
        "result": 14.5,
        "unit": "g/dL",
        "evaluation": "طبيعي",
        "range_min": 10.0,
        "range_max": 18.0,
        "range_normal_min": 13.5,
        "range_normal_max": 17.5,
        "short_description": "بروتين خلايا الدم الحمراء الذي ينقل الأكسجين.",
        "long_description": "الهيموجلوبين هو البروتين المحتوي على الحديد المسؤول عن نقل الأكسجين..."
      }
    ],
    "interpretation": [
      {
        "title": "تقييم الصحة العامة",
        "shortcode": "overall_health_assessment",
        "subsections": [
          {
            "subtitle": "نظرة عامة شاملة",
            "shortcode": "overall_health_assessment_overview",
            "items": [
              {"item": "يظهر المريض وظائف أعضاء محفوظة مع معايير دموية طبيعية."},
              {"item": "لم يتم اكتشاف شذوذات كبيرة في تعداد الدم الكامل."}
            ]
          }
        ]
      }
    ]
  },
  "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": "ar",
    "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": "فيتامين د",
            "explanation": "فيتامين د ضروري لصحة العظام والمناعة وتنظيم المزاج. مستواك 18 نانوغرام/مل يشير إلى نقص قد يؤثر على امتصاص الكالسيوم والصحة العامة.",
            "normal_range": "30-50 ng/mL"
          },
          {
            "marker": "كوليسترول LDL",
            "explanation": "كوليسترول LDL، المعروف بـ'الكوليسترول الضار'، يمكن أن يتراكم في جدران الشرايين. مستواك 140 ملغ/ديسيلتر مرتفع وقد يزيد خطر أمراض القلب.",
            "normal_range": "< 100 mg/dL"
          }
        ],
        "nutrition_principles": [
          "أعطِ الأولوية لأحماض أوميغا-3 الدهنية لصحة القلب",
          "زِد الألياف القابلة للذوبان لخفض كوليسترول LDL",
          "ضمّن أطعمة غنية بفيتامين د والتعرض لأشعة الشمس"
        ]
      }
    },
    "food_recommendations": {
      "power_foods": [
        {
          "food": "سمك السلمون البري",
          "nutrients": ["أوميغا-3", "فيتامين د", "البروتين"],
          "serving": "150 غرام، 3 مرات أسبوعياً",
          "why": "مصدر ممتاز لأوميغا-3 وفيتامين د الطبيعي لصحة القلب والعظام"
        },
        {
          "food": "الشوفان الكامل",
          "nutrients": ["بيتا-جلوكان", "الألياف", "المغنيسيوم"],
          "serving": "50 غرام يومياً على الإفطار",
          "why": "الألياف القابلة للذوبان في الشوفان تساعد على تقليل امتصاص كوليسترول LDL"
        },
        {
          "food": "زيت الزيتون البكر الممتاز",
          "nutrients": ["دهون أحادية غير مشبعة", "بوليفينول", "فيتامين هـ"],
          "serving": "2-3 ملاعق كبيرة يومياً",
          "why": "الدهون الصحية المتوسطية تحسن ملف الدهون وتحمي القلب"
        },
        {
          "food": "السبانخ",
          "nutrients": ["الحديد", "حمض الفوليك", "فيتامين ك"],
          "serving": "100 غرام يومياً، نيئة أو مطبوخة",
          "why": "غني بالحديد ومضادات الأكسدة للطاقة وصحة القلب والأوعية"
        }
      ]
    },
    "supplement_recommendations": [
      {
        "supplement": "فيتامين د3",
        "dosage": "2000-4000 وحدة دولية يومياً",
        "timing": "مع الإفطار (وجبة تحتوي على دهون)",
        "duration": "3-6 أشهر، ثم إعادة الفحص",
        "reason": "مستواك 18 نانوغرام/مل أقل من المستوى الأمثل 30-50 نانوغرام/مل"
      },
      {
        "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"
}

يحلل سلسلة زمنية من فحوصات الدم (2-50 اختبار) ويوفر رؤى إحصائية، اكتشاف الأنماط، وتفسيرات AI لاتجاهات المعايير.

معاملات الطلب

كائن 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": "ar",
    "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": 105, "unit": "mg/dL"},
          {"short_name": "HbA1c", "result": 6.2, "unit": "%"},
          {"short_name": "CHOL", "result": 220, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 140, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 45, "unit": "mg/dL"}
        ]
      },
      {
        "test_date": "2024-05-10",
        "parameters": [
          {"short_name": "GLU", "result": 98, "unit": "mg/dL"},
          {"short_name": "HbA1c", "result": 5.9, "unit": "%"},
          {"short_name": "CHOL", "result": 210, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 130, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 48, "unit": "mg/dL"}
        ]
      },
      {
        "test_date": "2024-08-22",
        "parameters": [
          {"short_name": "GLU", "result": 92, "unit": "mg/dL"},
          {"short_name": "HbA1c", "result": 5.6, "unit": "%"},
          {"short_name": "CHOL", "result": 195, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 115, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 52, "unit": "mg/dL"}
        ]
      },
      {
        "test_date": "2024-12-18",
        "parameters": [
          {"short_name": "GLU", "result": 88, "unit": "mg/dL"},
          {"short_name": "HbA1c", "result": 5.4, "unit": "%"},
          {"short_name": "CHOL", "result": 185, "unit": "mg/dL"},
          {"short_name": "LDL", "result": 105, "unit": "mg/dL"},
          {"short_name": "HDL", "result": 55, "unit": "mg/dL"}
        ]
      }
    ]
  }'

مثال Python

import requests
from typing import List, Dict

def analyze_trends(
    blood_tests: List[Dict],
    username: str,
    password: str,
    language: str = "ar",
    analysis_type: str = "comprehensive"
):
    """
    تحليل اتجاهات فحوصات الدم عبر الزمن.

    Args:
        blood_tests: قائمة من فحوصات الدم بترتيب زمني
        username: اسم مستخدم API
        password: كلمة مرور API
        language: رمز لغة الاستجابة
        analysis_type: نوع التحليل (comprehensive، statistical، summary)

    Returns:
        dict: استجابة API مع تحليل الاتجاهات
    """
    url = "https://app.aibloodtestinterpret.com/api/v1/analytics/trends/analyze"

    payload = {
        "username": username,
        "password": password,
        "language": language,
        "analysis_type": analysis_type,
        "blood_tests": blood_tests
    }

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

# مثال الاستخدام
if __name__ == "__main__":
    blood_tests = [
        {
            "test_date": "2024-06-01",
            "parameters": [
                {"short_name": "WBC", "result": 6.5, "unit": "10^9/L"},
                {"short_name": "CHOL", "result": 210, "unit": "mg/dL"}
            ]
        },
        {
            "test_date": "2024-09-01",
            "parameters": [
                {"short_name": "WBC", "result": 7.1, "unit": "10^9/L"},
                {"short_name": "CHOL", "result": 195, "unit": "mg/dL"}
            ]
        },
        {
            "test_date": "2024-12-01",
            "parameters": [
                {"short_name": "WBC", "result": 7.2, "unit": "10^9/L"},
                {"short_name": "CHOL", "result": 185, "unit": "mg/dL"}
            ]
        }
    ]

    result = analyze_trends(
        blood_tests=blood_tests,
        username="اسم_المستخدم",
        password="كلمة_المرور",
        language="ar"
    )
    print(f"الحالة: {result['status']}")
    print(f"المعلمات المحللة: {len(result['data']['trends'])}")

مثال استجابة

{
  "status": "success",
  "data": {
    "summary": {
      "total_tests": 3,
      "date_range": {
        "start": "2024-06-01",
        "end": "2024-12-01"
      },
      "parameters_tracked": 3,
      "overall_assessment": "تحسن إيجابي في الصحة العامة"
    },
    "trends": [
      {
        "parameter": {
          "short_name": "CHOL",
          "long_name": "الكوليسترول الكلي",
          "category": "لوحة الدهون"
        },
        "statistics": {
          "min": 185,
          "max": 210,
          "mean": 196.67,
          "median": 195,
          "std_dev": 12.58,
          "coefficient_of_variation": 6.4
        },
        "trend_analysis": {
          "direction": "downward",
          "strength": "moderate",
          "assessment": "improving",
          "percentage_change": -11.9,
          "rate_of_change": -4.17
        },
        "time_series": [
          {
            "date": "2024-06-01",
            "value": 210,
            "evaluation": "borderline_high",
            "deviation_from_normal": 5.0
          },
          {
            "date": "2024-09-01",
            "value": 195,
            "evaluation": "normal",
            "deviation_from_normal": -2.5
          },
          {
            "date": "2024-12-01",
            "value": 185,
            "evaluation": "normal",
            "deviation_from_normal": -7.5
          }
        ],
        "interpretation": "يُظهر الكوليسترول الكلي اتجاهًا تنازليًا إيجابيًا من 210 إلى 185 ملغ/ديسيلتر على مدى 6 أشهر. هذا تحسن بنسبة 11.9% يشير إلى فعالية تغييرات نمط الحياة أو العلاج."
      },
      {
        "parameter": {
          "short_name": "WBC",
          "long_name": "خلايا الدم البيضاء",
          "category": "تعداد الدم الكامل"
        },
        "statistics": {
          "min": 6.5,
          "max": 7.2,
          "mean": 6.93,
          "median": 7.1,
          "std_dev": 0.36,
          "coefficient_of_variation": 5.2
        },
        "trend_analysis": {
          "direction": "upward",
          "strength": "mild",
          "assessment": "stable",
          "percentage_change": 10.8,
          "rate_of_change": 0.12
        },
        "time_series": [
          {
            "date": "2024-06-01",
            "value": 6.5,
            "evaluation": "normal",
            "deviation_from_normal": 0
          },
          {
            "date": "2024-09-01",
            "value": 7.1,
            "evaluation": "normal",
            "deviation_from_normal": 0
          },
          {
            "date": "2024-12-01",
            "value": 7.2,
            "evaluation": "normal",
            "deviation_from_normal": 0
          }
        ],
        "interpretation": "تُظهر خلايا الدم البيضاء زيادة طفيفة ولكنها تبقى ضمن النطاق الطبيعي. التباين منخفض (5.2%) مما يشير إلى استقرار جيد للجهاز المناعي."
      }
    ],
    "patterns": {
      "correlations": [
        {
          "parameters": ["CHOL", "LDL"],
          "correlation_coefficient": 0.92,
          "description": "ارتباط قوي بين الكوليسترول الكلي وLDL"
        }
      ],
      "anomalies": [],
      "significant_changes": [
        {
          "parameter": "CHOL",
          "change_description": "انخفاض كبير بنسبة 11.9% في الكوليسترول",
          "clinical_significance": "إيجابي - يقلل من خطر أمراض القلب والأوعية الدموية"
        }
      ]
    },
    "recommendations": [
      {
        "priority": "high",
        "recommendation": "استمر في تدابير خفض الكوليسترول الحالية"
      },
      {
        "priority": "medium",
        "recommendation": "راقب WBC في الاختبار التالي للتأكد من الاستقرار"
      },
      {
        "priority": "low",
        "recommendation": "جدولة اختبار المتابعة في 3 أشهر"
      }
    ]
  },
  "api_version": "v1",
  "timestamp": "2025-12-22T10:30:00Z"
}

مرجع حقول الاستجابة

المستوى الجذري

كائن data.summary

عنصر مصفوفة data.trends

كائن trend_analysis

كائن data.patterns

يوفر مقارنات سردية مدعومة بالذكاء الاصطناعي بين فحوصات الدم المتعددة، مع التركيز على التغييرات ذات المغزى والرؤى الطبية.

معاملات الطلب

هيكل مصفوفة 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": "ar",
    "blood_tests": [
      {
        "test_date": "2024-06-01",
        "parameters": [
          {"short_name": "WBC", "result": 6.5, "unit": "10^9/L", "evaluation": "normal"},
          {"short_name": "HGB", "result": 13.8, "unit": "g/dL", "evaluation": "borderline_low"},
          {"short_name": "CHOL", "result": 220, "unit": "mg/dL", "evaluation": "high"}
        ]
      },
      {
        "test_date": "2024-12-01",
        "parameters": [
          {"short_name": "WBC", "result": 7.2, "unit": "10^9/L", "evaluation": "normal"},
          {"short_name": "HGB", "result": 14.5, "unit": "g/dL", "evaluation": "normal"},
          {"short_name": "CHOL", "result": 185, "unit": "mg/dL", "evaluation": "normal"}
        ]
      }
    ]
  }'

مثال Python

import requests
from typing import List, Dict

def compare_blood_tests(
    blood_tests: List[Dict],
    username: str,
    password: str,
    language: str = "ar"
):
    """
    قارن فحوصات دم متعددة باستخدام AI.

    Args:
        blood_tests: قائمة من 2-20 فحص دم بترتيب زمني
        username: اسم مستخدم API
        password: كلمة مرور API
        language: رمز لغة الاستجابة

    Returns:
        dict: استجابة API مع تحليل المقارنة
    """
    url = "https://app.aibloodtestinterpret.com/api/v1/bloodtest/comparison/analyze"

    payload = {
        "username": username,
        "password": password,
        "language": language,
        "blood_tests": blood_tests
    }

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

# مثال الاستخدام
if __name__ == "__main__":
    blood_tests = [
        {
            "test_date": "2024-06-01",
            "parameters": [
                {"short_name": "WBC", "result": 6.5, "unit": "10^9/L", "evaluation": "normal"},
                {"short_name": "CHOL", "result": 220, "unit": "mg/dL", "evaluation": "high"}
            ]
        },
        {
            "test_date": "2024-12-01",
            "parameters": [
                {"short_name": "WBC", "result": 7.2, "unit": "10^9/L", "evaluation": "normal"},
                {"short_name": "CHOL", "result": 185, "unit": "mg/dL", "evaluation": "normal"}
            ]
        }
    ]

    result = compare_blood_tests(
        blood_tests=blood_tests,
        username="اسم_المستخدم",
        password="كلمة_المرور",
        language="ar"
    )
    print(f"الحالة: {result['status']}")
    print(result['data']['summary'])

مثال استجابة

{
  "status": "success",
  "data": {
    "comparison_summary": {
      "tests_compared": 2,
      "date_range": {
        "first_test": "2024-06-01",
        "last_test": "2024-12-01"
      },
      "time_span_days": 183,
      "parameters_compared": 3,
      "overall_trend": "improving"
    },
    "parameter_comparisons": [
      {
        "parameter": {
          "short_name": "CHOL",
          "long_name": "الكوليسترول الكلي",
          "category": "لوحة الدهون"
        },
        "comparison": {
          "first_value": 220,
          "last_value": 185,
          "absolute_change": -35,
          "percentage_change": -15.9,
          "trend_assessment": "improving"
        },
        "evaluations": {
          "first_test": "high",
          "last_test": "normal"
        },
        "narrative": "انخفض الكوليسترول الكلي من 220 إلى 185 ملغ/ديسيلتر، وهو تحسن ممتاز بنسبة 15.9%. تحرك من النطاق المرتفع إلى الطبيعي، مما يشير إلى تعديلات فعالة لنمط الحياة أو العلاج. يقلل هذا من خطر الإصابة بأمراض القلب والأوعية الدموية."
      },
      {
        "parameter": {
          "short_name": "HGB",
          "long_name": "الهيموجلوبين",
          "category": "تعداد الدم الكامل"
        },
        "comparison": {
          "first_value": 13.8,
          "last_value": 14.5,
          "absolute_change": 0.7,
          "percentage_change": 5.1,
          "trend_assessment": "improving"
        },
        "evaluations": {
          "first_test": "borderline_low",
          "last_test": "normal"
        },
        "narrative": "زاد الهيموجلوبين من 13.8 إلى 14.5 غ/ديسيلتر، تحسن بنسبة 5.1%. تحرك من النطاق الحدي المنخفض إلى الطبيعي، مما يشير إلى تحسن قدرة حمل الأكسجين في الدم وانخفاض محتمل في خطر فقر الدم."
      },
      {
        "parameter": {
          "short_name": "WBC",
          "long_name": "خلايا الدم البيضاء",
          "category": "تعداد الدم الكامل"
        },
        "comparison": {
          "first_value": 6.5,
          "last_value": 7.2,
          "absolute_change": 0.7,
          "percentage_change": 10.8,
          "trend_assessment": "stable"
        },
        "evaluations": {
          "first_test": "normal",
          "last_test": "normal"
        },
        "narrative": "بقيت خلايا الدم البيضاء مستقرة ضمن النطاق الطبيعي، مع زيادة طفيفة من 6.5 إلى 7.2. يشير هذا إلى وظيفة مناعية صحية ثابتة بدون مخاوف."
      }
    ],
    "ai_interpretation": {
      "overall_health_assessment": "تُظهر فحوصات الدم تحسنًا إجماليًا إيجابيًا على مدى 6 أشهر. التحسينات الأكثر أهمية هي في ملف الدهون (الكوليسترول -15.9%) ومستويات الهيموجلوبين (+5.1%). جميع المعايير الآن ضمن النطاقات الطبيعية.",
      "key_improvements": [
        {
          "parameter": "الكوليسترول الكلي",
          "description": "انخفاض كبير من مستويات عالية إلى طبيعية",
          "clinical_significance": "يقلل من خطر الإصابة بأمراض القلب والأوعية الدموية"
        },
        {
          "parameter": "الهيموجلوبين",
          "description": "تحسن من حدي منخفض إلى طبيعي",
          "clinical_significance": "تحسن قدرة حمل الأكسجين ومستويات الطاقة"
        }
      ],
      "areas_of_concern": [],
      "recommendations": [
        "استمر في تدابير إدارة الكوليسترول الحالية (النظام الغذائي، التمارين، الأدوية إن وجدت)",
        "حافظ على تناول كافٍ للحديد والعناصر الغذائية لدعم مستويات الهيموجلوبين",
        "جدولة اختبار متابعة في 6 أشهر للتأكد من الحفاظ على هذه التحسينات"
      ]
    }
  },
  "api_version": "v1",
  "timestamp": "2025-12-22T10:30:00Z"
}

مرجع حقول الاستجابة

المستوى الجذري

كائن data.comparison_summary

عنصر مصفوفة data.parameter_comparisons

كائن comparison

كائن data.ai_interpretation

يُرجع معلومات منصة API، الإصدارات المتاحة والميزات المدعومة. لا يتطلب مصادقة.

مثال استجابة

{
  "platform": "منصة API Kantesti لتحليل الدم",
  "versions": ["v6", "v8", "v9", "v10", "v11"],
  "latest_version": "v11",
  "supported_languages": 100,
  "documentation": "https://www.kantesti.net/docs/",
  "status": "operational"
}

تحقق من حصة API المتبقية. يتطلب المصادقة.

مثال cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/quota/check" \
  -H "Content-Type: application/json" \
  -d '{"username": "اسم_المستخدم", "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":"ar"}'

مثال 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":"ar"}
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=ar" \
  -F "[email protected]"

مثال Python

import requests

def icr_extract(file_path: str, username: str, password: str, language: str = "ar"):
    """
    استخراج النص من مستند باستخدام واجهة 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", "المستخدم", "كلمة_المرور", "ar")
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": "ar", "confidence": "high"},
    "icr_metadata": {"engine": "kantesti-icr", "version": "1.0.0"}
  },
  "credit_cost": 0.5,
  "api_version": "icr-v1"
}