البحث، متصلًا.

01

أول استعلام بحثي لك

ابحث في الكتالوج واتبع كل نتيجة إلى مصدرها العلمي. احتفظ بمفتاحك على خادمك، خارج كود المتصفح.

curl -H "Authorization: Bearer $ONCORADAR_API_KEY" \
  "https://api.oncoradar.net/api/v1/search?q=EGFR+lung+cancer&limit=20"

يبقى المصدر العلمي الأصلي هو المرجع المعتمد. ولا يقيس ترتيب البحث والتشابه مستوى الدليل السريري.

02

المصادقة والنطاقات

صادِق باستخدام مفتاح OncoRadar API في ترويسة Bearer. تتحقق كل عملية من أذونات المشروع والقبول القانوني الحالي.

Authorization: Bearer okr_your_api_key
Accept: application/json

النطاقات الأساسية

مسارات الموارد

تتيح API الدراسات والتجارب السريرية والإشارات والمجموعات والتنبيهات والتوليف البحثي.

GET /api/v1/studies/{id}
GET /api/v1/trials/{nctId}

03

ترقيم الصفحات والأخطاء

مرّر المؤشر غير الشفاف من الاستجابة دون تغيير إلى الطلب التالي. أجرِ بحثًا جديدًا عند تغيّر عوامل التصفية. تقتصر إعادة المحاولات في SDK على القراءات الآمنة والاستجابات القابلة لإعادة المحاولة.

{
  "error": { "code": "…", "message": "…" },
  "requestId": "…"
}

04

Webhooks موقّعة

يتم التسليم مرة واحدة على الأقل. تحقّق من التوقيع على بايتات timestamp.payload الخام، وارفض الطوابع الزمنية خارج نافذة مدتها خمس دقائق، وأزل التكرارات ذريًا قبل تطبيق التأثيرات. يجب أن تعيد التكرارات الصالحة استجابة 2xx.

X-OncoRadar-Signature
X-OncoRadar-Delivery
Idempotency-Key

يجب أن تستخدم الوجهات HTTPS عامًا، وألا تُحيل إلى شبكات خاصة أو محجوزة. ويغطي دليل webhooks في المستودع أمثلة على المستقبِلات، وإعادة المحاولات، وتدوير المفاتيح ذي الإصدارات.

05

MCP لأدوات البحث

أرسل طلبات JSON-RPC باستخدام مفتاح API الخاص بك. تتم تصفية الأدوات والموارد حسب النطاقات، مع حدود ومراعاة للترخيص. لا تعلن نقطة النهاية عن OAuth.

إصدار البروتوكول: 2025-06-18

POST /api/mcp

oncoradar://study/{id}
oncoradar://trial/{nctId}
oncoradar://collection/{id}
oncoradar://topic/{id}

06

SDKs

يوجد مصدر SDK لـ TypeScript وPython في المستودع. هذه عناصر مصدرية وليست حزمًا منشورة. وتتضمن المصادقة بمفتاح API، وإعادة المحاولات الآمنة، وأدوات ترقيم الصفحات، ومساعدات REST/MCP.