API Documentation

Base URL

https://drug.elbaset.com/api/v1

Authentication

All endpoints require a Bearer token issued from the API Tokens page (login required).

Authorization: Bearer YOUR_TOKEN

POST /api/v1/check

Run drug-drug interaction check on 2-10 drugs.

Request

curl -X POST https://drug.elbaset.com/api/v1/check \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "drugs": ["Augmentin", "Warfarin", "Aspirin"]
  }'

Response (200 OK)

{
  "overall_severity": "major",
  "interactions": [
    {
      "ingredient_a": { "id": 14425, "name_en": "warfarin", "name_ar": null },
      "ingredient_b": { "id": 1686,  "name_en": "aspirin",  "name_ar": null },
      "severity": "major",
      "mechanism": "...",
      "clinical_effect": "...",
      "management": "...",
      "source": "ddinter",
      "source_reference": "DDInter 2.0",
      "drugs": [{ "label": "Warfarin" }, { "label": "Aspirin" }]
    }
  ],
  "ingredients": [...],
  "warnings": [],
  "resolution": [
    { "input": "Augmentin", "source": "local", "brand": "Augmentin Duo", "ingredients": ["amoxicillin"] },
    ...
  ],
  "response_time_ms": 47,
  "query_id": 123
}

Severity values

• major — تعارض خطير، تجنب الجمع
• moderate — تعارض متوسط، يحتاج مراقبة
• minor — تعارض بسيط
• none — لا يوجد تعارض موثّق

GET /api/v1/drugs/autocomplete

Fast local autocomplete for drug names (no AI fallback).

curl "https://drug.elbaset.com/api/v1/drugs/autocomplete?q=warfa" \
  -H "Authorization: Bearer YOUR_TOKEN"

POST /api/v1/drugs/resolve

Resolve a single drug name to active ingredients (uses AI fallback for unknown brands).

curl -X POST https://drug.elbaset.com/api/v1/drugs/resolve \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Augmentin"}'

Error responses

• 401 Unauthorized — توكن غير صحيح أو منتهي
• 422 Unprocessable Entity — بيانات الإدخال غير صحيحة
• 429 Too Many Requests — تجاوز الحد المسموح
• 500 Internal Server Error — خطأ في الخادم