Forskning, sammankopplad.

01

Er första forskningsfråga

Sök i katalogen och följ varje resultat tillbaka till dess vetenskapliga källa. Förvara nyckeln på er server, utanför webbläsarkoden.

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

Den ursprungliga vetenskapliga källan förblir auktoriteten. Sökningsordning och likhet mäter inte klinisk evidens.

02

Autentisering och behörigheter

Autentisera med en OncoRadar API-nyckel i Bearer-huvudet. Varje åtgärd kontrollerar projektbehörigheter och aktuell juridisk acceptans.

Authorization: Bearer okr_your_api_key
Accept: application/json

Kärnbehörigheter

Resursrutter

API:et exponerar studier, kliniska prövningar, signaler, samlingar, aviseringar och forskningssynteser.

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

03

Paginering och fel

Skicka den ogenomskinliga markören från ett svar oförändrad i nästa begäran. Gör en ny sökning när filtren ändras. SDK:er försöker endast läsa om säkert och vid svar som kan försökas igen.

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

04

Signerade webhooks

Leverans sker minst en gång. Verifiera signaturen över de råa timestamp.payload-bytesen, avvisa tidsstämplar utanför ett femminutersfönster och deduplicera leveransen atomärt innan effekter tillämpas. Giltiga dubbletter ska returnera 2xx.

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

Destinationer måste använda offentlig HTTPS och får inte slå upp till privata eller reserverade nätverk. Arkivets webhook-guide innehåller exempel på mottagare, omförsök och versionshanterad nyckelrotation.

05

MCP för forskningsverktyg

Skicka JSON-RPC-begäranden med er API-nyckel. Verktyg och resurser filtreras efter behörigheter, är avgränsade och licensmedvetna. Slutpunkten annonserar inte OAuth.

Protokollversion: 2025-06-18

POST /api/mcp

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

06

SDK:er

Källan till TypeScript- och Python-SDK:erna finns i arkivet. Detta är källkodartefakter, inte publicerade paket. De omfattar API-nyckelautentisering, säkra omförsök, paginerare och REST/MCP-hjälpfunktioner.