Forschung, vernetzt.

01

Ihre erste Forschungsabfrage

Durchsuchen Sie den Katalog und verfolgen Sie jedes Ergebnis bis zu seiner wissenschaftlichen Quelle zurück. Bewahren Sie Ihren Schlüssel auf Ihrem Server auf, außerhalb von Browsercode.

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

Die ursprüngliche wissenschaftliche Quelle bleibt maßgeblich. Suchreihenfolge und Ähnlichkeit messen nicht die klinische Evidenz.

02

Authentifizierung und Berechtigungsbereiche

Authentifizieren Sie sich mit einem OncoRadar-API-Schlüssel im Bearer-Header. Jede Operation prüft Projektberechtigungen und die aktuelle rechtliche Zustimmung.

Authorization: Bearer okr_your_api_key
Accept: application/json

Zentrale Berechtigungsbereiche

Routen für Ressourcen

Die API stellt Studien, klinische Studien, Signale, Sammlungen, Warnungen und Forschungssynthesen bereit.

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

03

Seitennummerierung und Fehler

Übergeben Sie den undurchsichtigen Cursor aus einer Antwort unverändert an die nächste Anfrage. Starten Sie eine neue Suche, wenn sich Filter ändern. SDK-Wiederholungen sind auf sichere Lesevorgänge und wiederholbare Antworten beschränkt.

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

04

Signierte Webhooks

Die Zustellung erfolgt mindestens einmal. Überprüfen Sie die Signatur über die unveränderten timestamp.payload-Bytes, weisen Sie Zeitstempel außerhalb eines Zeitfensters von fünf Minuten zurück und deduplizieren Sie die Zustellung atomar, bevor Sie Auswirkungen anwenden. Gültige Duplikate sollten mit 2xx beantwortet werden.

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

Ziele müssen öffentliches HTTPS verwenden und dürfen nicht in private oder reservierte Netzwerke aufgelöst werden. Der Webhook-Leitfaden im Repository behandelt Empfängerbeispiele, Wiederholungen und die versionierte Schlüsselrotation.

05

MCP für Forschungswerkzeuge

Senden Sie JSON-RPC-Anfragen mit Ihrem API-Schlüssel. Werkzeuge und Ressourcen werden nach Berechtigungsbereichen gefiltert, sind begrenzt und berücksichtigen Lizenzen. Der Endpunkt kündigt OAuth nicht an.

Protokollversion: 2025-06-18

POST /api/mcp

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

06

SDKs

Der Quellcode der TypeScript- und Python-SDKs befindet sich im Repository. Es handelt sich um Quellartefakte, nicht um veröffentlichte Pakete. Sie umfassen API-Schlüssel-Authentifizierung, sichere Wiederholungen, Seitennummerierung und REST/MCP-Hilfsfunktionen.