शोध, जुड़ा हुआ।

01

आपकी पहली शोध क्वेरी

कैटलॉग में खोजें और प्रत्येक परिणाम को उसके वैज्ञानिक स्रोत तक वापस फॉलो करें। अपनी कुंजी सर्वर पर रखें, ब्राउज़र कोड से बाहर।

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

मूल वैज्ञानिक स्रोत ही प्राधिकृत स्रोत रहता है। खोज क्रम और समानता नैदानिक साक्ष्य को नहीं मापते।

02

प्रमाणीकरण और स्कोप

Bearer हेडर में OncoRadar API कुंजी के साथ प्रमाणीकरण करें। प्रत्येक ऑपरेशन प्रोजेक्ट अनुमतियों और वर्तमान कानूनी स्वीकृति की जाँच करता है।

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

हस्ताक्षरित वेबहुक

डिलीवरी कम-से-कम एक बार होती है। कच्चे timestamp.payload बाइट्स पर हस्ताक्षर सत्यापित करें, पाँच मिनट की विंडो से बाहर के टाइमस्टैम्प अस्वीकार करें और प्रभाव लागू करने से पहले डिलीवरी के डुप्लिकेट को परमाणु रूप से हटाएँ। मान्य डुप्लिकेट को 2xx लौटाना चाहिए।

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

डेस्टिनेशन को सार्वजनिक HTTPS का उपयोग करना चाहिए और निजी या आरक्षित नेटवर्क पर रिज़ॉल्व नहीं होना चाहिए। रिपॉज़िटरी की वेबहुक गाइड में रिसीवर के उदाहरण, पुनःप्रयास और संस्करणित कुंजी रोटेशन शामिल हैं।

05

शोध टूल के लिए MCP

अपनी API कुंजी का उपयोग करके JSON-RPC अनुरोध भेजें। टूल और संसाधन स्कोप के अनुसार फ़िल्टर किए जाते हैं, सीमित हैं और लाइसेंस के अनुरूप हैं। एंडपॉइंट OAuth का विज्ञापन नहीं करता।

प्रोटोकॉल संस्करण: 2025-06-18

POST /api/mcp

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

06

SDKs

TypeScript और Python SDK का स्रोत रिपॉज़िटरी में है। ये स्रोत आर्टिफैक्ट हैं, प्रकाशित पैकेज नहीं। इनमें API-कुंजी प्रमाणीकरण, सुरक्षित पुनःप्रयास, पेजिनेटर और REST/MCP हेल्पर शामिल हैं।