نقاط نهاية API تحليل الدم

نقطة نهاية الإنتاج لتحليل الدم. ارفع صورة واحدة أو أكثر لفحص الدم أو ملف PDF، واحصل على معايير منظمة، وبيانات وصفية عن المريض والمختبر، وتفسير سريري كامل بأي من اللغات الـ100 المدعومة. يستهلك رصيدًا واحدًا لكل طلب.

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

مثال cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v12/18-09-2026/analyze" \
  -F "username=اسم_المستخدم" \
  -F "password=كلمة_المرور" \
  -F "language=ar" \
  -F "file=@blood_test.pdf"

مثال Python

import requests

def analyze_blood_test(file_paths, username, password, language="ar"):
    """
    تحليل فحص دم باستخدام Kantesti Blood Test Analysis v12.

    Args:
        file_paths: مسار واحد أو أكثر لصور فحص الدم، أو ملف PDF واحد
        username: اسم مستخدم API
        password: كلمة مرور API
        language: رمز لغة التقرير (افتراضي: ar)

    Returns:
        dict: معايير منظمة وبيانات وصفية وتفسير سريري
    """
    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(
    file_paths=["blood_test.pdf"],
    username="your_username",
    password="your_password",
    language="ar"
)
for param in result["data"]["parameters"]:
    print(f"{param['short_name']}: {param['result']} {param['unit']} ({param['evaluation']})")

مثال على الاستجابة

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

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

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

مثال 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

نقطة نهاية الإنتاج مع حساب شامل لدرجة الصحة وتحليل مخاطر الأمراض. تأخذ الطلب نفسه الذي تأخذه /api/v12/18-09-2026/analyze وتضيف الحقول أدناه إلى الاستجابة. تستهلك رصيدًا واحدًا لكل طلب.

مثال cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v12/health-score/analyze" \
  -F "username=اسم_المستخدم" \
  -F "password=كلمة_المرور" \
  -F "language=ar" \
  -F "file=@blood_test.pdf"

حقول الاستجابة الإضافية

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

ينشئ توصيات شاملة للتغذية والمكملات بناءً على معلمات فحص الدم وملف المريض.

مخطط كائن المريض

وصف تفصيلي لجميع الحقول المتاحة لكائن المريض:

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

كائن 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

يضع كل نتيجة مُعلَّمة في لوحة التحاليل على الجسم. يستهلك رصيدًا واحدًا لكل طلب ناجح. الطلب الذي يفشل في التحقق، أو الذي تتعذّر مطابقة مؤشراته المُعلَّمة بأي منطقة، لا تتم محاسبته.

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

حقول كائن parameters

مثال cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/body-map/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "اسم_المستخدم",
    "password": "كلمة_المرور",
    "parameters": [
      {"short_name": "ALT", "long_name": "Alanine aminotransferase", "result": "65", "unit": "U/L", "range_normal_min": 7, "range_normal_max": 45, "evaluation": "high"},
      {"short_name": "AST", "long_name": "Aspartate aminotransferase", "result": "48", "unit": "U/L", "range_normal_min": 8, "range_normal_max": 40, "evaluation": "slightly_high"},
      {"short_name": "TSH", "long_name": "Thyrotropin", "result": "6.2", "unit": "mIU/L", "range_normal_min": 0.4, "range_normal_max": 4.0, "evaluation": "high"}
    ]
  }'

مثال Python

import requests

def build_body_map(parameters, username, password, include_image=False):
    """
    وضع نتائج فحص الدم الخارجة عن النطاق على خريطة الجسم.

    Args:
        parameters: قائمة كائنات نتائج المختبر
        username: اسم مستخدم API
        password: كلمة مرور API
        include_image: طلب الرسم التوضيحي المُنتَج (يستهلك رصيد صور)

    Returns:
        dict: كتلة خريطة الجسم مع المناطق والمفتاح وروابط الرسم
    """
    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="your_username",
    password="your_password",
)

body_map = result["data"]["body_map"]
for region in body_map["regions"]:
    print(f"{region['key']}: level {region['level']} ({', '.join(region['markers'])})")

مثال على الاستجابة

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

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

يتحقق من الحمولة دون تشغيل التحليل، ويبيّن أي أسماء التحاليل لديك يتعرف عليها المحرك. المصادقة مطلوبة؛ ولا يُستهلك أي رصيد، وتظل نقطة النهاية تعمل على حساب بلا رصيد متبقٍ.

مثال cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/body-map/validate" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "اسم_المستخدم",
    "password": "كلمة_المرور",
    "parameters": [
      {"short_name": "ALT", "result": "65", "evaluation": "high"},
      {"short_name": "Unobtainium", "result": "9", "evaluation": "high"}
    ]
  }'

مثال على الاستجابة

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

يسرد مناطق الجسم الـ13 بالترتيب القياسي مع مستويات الشدة. استخدمه لبناء ترجماتك الخاصة لمفتاح الخريطة.

مثال cURL

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

مثال على الاستجابة

{
  "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",
      "1": "borderline",
      "2": "out of range"
    },
    "count": 13
  }
}

بيانات وصفية عن القدرات: ما إذا كان المحرك مفعّلاً على هذا النشر، وحدود الطلب، ونظام المصادقة، وقائمة نقاط النهاية الكاملة.

مثال cURL

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

يحسب العمر البيولوجي للدم والمؤشرات المشتقة من لوحة تحاليل مخبرية. يستهلك رصيدًا واحدًا لكل طلب ناجح. الطلب الذي يفشل في التحقق، أو الذي لا تعطي لوحته أي نتيجة قابلة للحساب، لا تتم محاسبته.

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

مؤشرات PhenoAge التسعة

أرسلها بالأسماء التي طبعها مختبرك — فالمطابقة بالاسم وبأي من لغات التقارير الـ39 المدعومة، والوحدات تُحوَّل تلقائياً.

مثال cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/blood-age/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "اسم_المستخدم",
    "password": "كلمة_المرور",
    "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}
    ]
  }'

مثال Python

import requests

def biological_blood_age(parameters, metadata, username, password):
    """
    حساب العمر البيولوجي للدم من لوحة تحاليل روتينية.

    Args:
        parameters: قائمة كائنات نتائج المختبر
        metadata: ترويسة التقرير التي تحمل patient_age و patient_sex
        username: اسم مستخدم API
        password: كلمة مرور API

    Returns:
        dict: كتلة العمر البيولوجي والمؤشرات المشتقة وملخص مسطّح
    """
    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="your_username",
    password="your_password",
)

summary = result["data"]["summary"]
print(f"chronological: {summary['chronological_age']}")
print(f"biological:    {summary['biological_age']} ({summary['source']})")

مثال على الاستجابة

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

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

يتحقق من الحمولة دون تشغيل التحليل، ويبيّن أي مؤشرات PhenoAge التسعة توفرها لوحتك وما إذا أمكن قراءة عمر زمني — وهما الأمران اللذان يحددان إن كنت ستحصل على المعادلة الكاملة أم على التقدير الجزئي. المصادقة مطلوبة؛ ولا يُستهلك أي رصيد، وتظل نقطة النهاية تعمل على حساب بلا رصيد متبقٍ.

مثال cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/blood-age/validate" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "اسم_المستخدم",
    "password": "كلمة_المرور",
    "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": "%"}
    ]
  }'

مثال على الاستجابة

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

يسرد مدخلات PhenoAge التسعة، وكل مؤشر يستطيع المحرك قراءته مع وحدته المستهدفة، والمدى العمري الذي تنطبق عليه المعادلة.

مثال cURL

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

مثال على الاستجابة

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

بيانات وصفية عن القدرات: ما إذا كان المحرك مفعّلاً على هذا النشر، والوضعان وتكلفة كل منهما، وحدود الطلب، ونظام المصادقة، واللغات المدعومة.

مثال cURL

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

يفسّر فحص DNA واحداً ويُعيد تقريراً صحياً جينياً شاملاً. أرسل ملفاً بصيغة multipart/form-data، أو أسطر أنماط جينية ملصوقة بصيغة JSON. يُحلَّل الملف المرفوع أثناء انتظارك، لذا يُرَدّ على الملف غير المقروء فوراً بالرمز 400 دون أي تكلفة. ولا يُحتسب الرصيد الواحد إلا بعد إنتاج التقرير.

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

مثال cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/dna-interpretation/analyze?async=1" \
  -u "اسم_المستخدم:كلمة_المرور" \
  -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 "اسم_المستخدم:كلمة_المرور" "https://app.aibloodtestinterpret.com/api/jobs/JOB_ID"

مثال Python

import time
import requests

BASE = "https://app.aibloodtestinterpret.com"
AUTH = ("YOUR_USERNAME", "YOUR_PASSWORD")


def run(path, poll=True, **kwargs):
    """الإرسال بطلب POST في الوضع غير المتزامن، ثم الاستعلام من /api/jobs/<id> حتى يصبح التقرير جاهزاً."""
    resp = requests.post(f"{BASE}{path}?async=1", auth=AUTH, timeout=60, **kwargs)
    body = resp.json()
    if resp.status_code != 202:
        return body                      # خطأ، أو إجابة متزامنة
    while True:
        time.sleep(body.get("poll_interval_ms", 3000) / 1000)
        job = requests.get(f"{BASE}{body['poll_url']}", auth=AUTH, timeout=30).json()
        if job["status"] in ("completed", "failed"):
            return job["result"]["response"]


# 1) تفسير فحص DNA
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"])

مثال على الاستجابة

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

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

يحلّل الملف المرفوع تماماً كما تفعل /analyze ويبيّن ما عُثر عليه، دون استدعاء الذكاء الاصطناعي. المصادقة مطلوبة؛ ولا يُستهلك أي رصيد. استخدمه لفحص الملف قبل إنفاق رصيد.

مثال على الاستجابة

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

يجمع تقرير DNA مع تحليل دم مفسَّر في تقرير صحي واحد. تُصنَّف كل صلة بين نتيجة جينية وقيمة مخبرية، وتليها مصفوفة مخاطر وإجراءات ذات أولوية وخطة متابعة. يستهلك رصيدًا واحدًا لكل طلب ناجح.

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

مثال Python

# 2) التقرير الصحي DNA + الدم (يستخدم run() و dna من المثال أعلاه)
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"])

مثال على الاستجابة

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

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

يبني خطة مكملات مخصّصة من تقرير DNA وإجابات الاستبيان، واختيارياً من تحليل دم مفسَّر. يُطبَّق كتالوج منتجات عيادتك وإعدادات المستشار تلقائياً. يستهلك رصيدًا واحدًا لكل طلب ناجح.

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

مثال cURL

curl -X POST "https://app.aibloodtestinterpret.com/api/v1/dna-supplements/analyze?async=1" \
  -u "اسم_المستخدم:كلمة_المرور" \
  -H "Content-Type: application/json" \
  -d '{
    "dna_report": { ...data.report من تفسير فحص DNA... },
    "answers": {"diet_type": "vegetarian", "pregnancy": "no", "sun_exposure": "low", "goals": ["energy", "immunity"]},
    "language": "en"
  }'

مثال Python

# 3) خطة المكملات (تستخدم run() و dna و blood_test من الأمثلة أعلاه)
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"])

مثال على الاستجابة

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

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

يقرأ كتالوج منتجات عيادتك وإعدادات المستشار أو يحدّثها. إنه الكتالوج نفسه الموجود في لوحة العيادة وفي التغذية بالذكاء الاصطناعي (Nutrition Diet AI)، فالمنتج المضاف في مكان واحد يصبح متاحاً في كل مكان. المصادقة مطلوبة؛ ولا يُستهلك أي رصيد. أرسل catalogue أو settings أو كليهما؛ ويستبدل الكتالوج المُرسَل القائمة بأكملها.

مثال cURL

curl -X PUT "https://app.aibloodtestinterpret.com/api/v1/dna-supplements/settings" \
  -u "اسم_المستخدم:كلمة_المرور" \
  -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}
  }'

يستخرج جميع المحتوى النصي من المستندات المرفوعة باستخدام تقنية 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"
}