توثيق مطوري واجهة برمجة تطبيقات الأدوية
مرحباً بك في وثيقة مطوري DwaPrices API. توفر لك هذه الواجهة وصولاً فورياً وبسرعة فائقة لقاعدة بيانات الأدوية الشاملة (الأسعار الحالية، الأسعار السابقة، الشركات المصنعة، المكونات الفعالة، والباركود الدولي)، مما يتيح دمجها مباشرة في برامج الصيدليات، تطبيقات الموبايل، أو مواقع التجارة الإلكترونية الطبية.
ملاحظة هامة: الروابط المعروضة بالأسفل هي نسخة معاينة مجانية (Sample API) مخصصة للمطورين لاختبار أنظمتهم وتطبيقاتهم قبل الاشتراك الفعلي المدفوع.
رابط الـ Endpoint الرئيسي للمعاينة
يتم إرسال كافة الطلبات باستخدام بروتوكول GET إلى الرابط التالي:
https://dwaprices.com/sample-api.php
المعاملات المتاحة (Query Parameters)
يمكنك دمج المعاملات التالية مع الرابط لفلترة وتخصيص البيانات المرتجعة:
| المعامل | النوع | الوصف | مثال بالقيم |
|---|---|---|---|
| search | string | البحث بالاسم الإنجليزي، العربي، أو الباركود الدولي. | ?search=panadol |
| id | integer | جلب بيانات دواء واحد محدد بشكل دقيق ومباشر عبر الرقم التعريفي. | ?id=1 |
| company | string | فلترة وتصفية النتائج لعرض أدوية شركة معينة فقط. | ?company=novartis |
| limit | integer | تحديد عدد النتائج المعروضة في الصفحة الواحدة (الحد الأقصى 100). | ?limit=10 |
| page | integer | رقم الصفحة الحالية المراد جلبها لتسهيل عملية الـ Pagination. | ?page=2 |
أمثلة حية وتجريبية (اضغط للتجربة مباشرة)
- GET https://dwaprices.com/api-fady/sample-api.php?search=panadol (البحث عن بنادول في العينة)
هيكل استجابة الـ JSON الناجحة (Response JSON)
عند إرسال طلب صحيح، يعيد النظام مصفوفة كائنات بترميز UTF-8 لدعم اللغة العربية كالتالي:
{
"status": "success",
"data": [
{
"id": 24483,
"name": "panadol sinus relief pe 24 tablets",
"arabic": "بانادول ساينس ريليف بي 24 قرص",
"oldprice": "22.8",
"price": "39",
"active": "paracetamol(acetaminophen)+phenylepherine",
"company": "alexandria \u003E glaxo smithkline",
"description": "cold drugs",
"units": 2,
"dosage_form": "tablet",
"barcode": "6222010610787",
"imported": "imported",
"Date_updated": null,
"sold_times": 708
},
{
"id": 24482,
"name": "panadol migraine 30 tabs",
"arabic": "بانادول مايجرين 30 قرص",
"oldprice": "30",
"price": "51",
"active": "acetylsalicylic acid+caffeine+paracetamol(acetaminophen)",
"company": "alexandria \u003E glaxo smithkline",
"description": "analgesic",
"units": 3,
"dosage_form": "tablet",
"barcode": "6223013531765",
"imported": "imported",
"Date_updated": null,
"sold_times": 5264
},
{
"id": 24481,
"name": "panadol joint 24 er tabs",
"arabic": "بانادول جوينت للمفاصل اي ار 24 قرص",
"oldprice": "50",
"price": "67",
"active": "paracetamol(acetaminophen)",
"company": "alexandria \u003E glaxo smithkline",
"description": "antipyretic.analgesic",
"units": 2,
"dosage_form": "tablet",
"barcode": "6222010611319",
"imported": "imported",
"Date_updated": null,
"sold_times": 1763
},
{
"id": 24480,
"name": "panadol extra 24 f.c. tab",
"arabic": "بانادول اكسترا 24 قرص",
"oldprice": "54",
"price": "58",
"active": "caffeine+paracetamol(acetaminophen)",
"company": "alexandria \u003E glaxo smithkline",
"description": "analgesic.antipyretic.headache",
"units": 2,
"dosage_form": "tablet",
"barcode": "6222010610640",
"imported": "imported",
"Date_updated": null,
"sold_times": 7563
},
{
"id": 24479,
"name": "panadol night 20 f.c. tabs",
"arabic": "بانادول نايت 20 قرص",
"oldprice": "",
"price": "48",
"active": "paracetamol(acetaminophen)+diphenhydramine",
"company": "glaxo smithkline",
"description": "cold products",
"units": 2,
"dosage_form": "tablet",
"barcode": "",
"imported": "imported",
"Date_updated": null,
"sold_times": 637
}
],
"pagination": {
"total": 4,
"per_page": 1,
"current_page": 1,
"last_page": 4,
"from": 1,
"to": 1
},
"meta": {
"search_term": "panadol",
"company_filter": null,
"request_time": "2026-05-27 21:18:21"
}
}