Onderzoek, verbonden.

01

Uw eerste onderzoeksvraag

Doorzoek de catalogus en volg elk resultaat terug naar de wetenschappelijke bron. Bewaar uw sleutel op uw server, buiten browsercode.

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

De oorspronkelijke wetenschappelijke bron blijft leidend. Zoekvolgorde en gelijkenis meten geen klinisch bewijs.

02

Authenticatie en scopes

Authenticeer met een OncoRadar API-sleutel in de Bearer-header. Elke bewerking controleert projectmachtigingen en de actuele juridische acceptatie.

Authorization: Bearer okr_your_api_key
Accept: application/json

Kernscopes

Resource-routes

De API biedt studies, klinische studies, signalen, collecties, waarschuwingen en onderzoekssynthese.

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

03

Paginering en fouten

Geef de ondoorzichtige cursor uit een antwoord ongewijzigd door aan het volgende verzoek. Voer een nieuwe zoekopdracht uit wanneer filters wijzigen. SDK-herpogingen zijn beperkt tot veilige leesbewerkingen en antwoorden die opnieuw kunnen worden geprobeerd.

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

04

Ondertekende webhooks

Bezorging vindt minstens eenmaal plaats. Verifieer de handtekening over de onbewerkte bytes van timestamp.payload, wijs tijdstempels buiten een venster van vijf minuten af en dedupliceer de bezorging atomair voordat u effecten toepast. Geldige duplicaten moeten 2xx retourneren.

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

Bestemmingen moeten openbaar HTTPS gebruiken en mogen niet verwijzen naar private of gereserveerde netwerken. De webhook-handleiding in de repository behandelt voorbeelden van ontvangers, herpogingen en versiebeheerste sleutelrotatie.

05

MCP voor onderzoekstools

Verstuur JSON-RPC-verzoeken met uw API-sleutel. Tools en resources worden gefilterd op scopes, zijn afgebakend en houden rekening met licenties. Het endpoint kondigt OAuth niet aan.

Protocolversie: 2025-06-18

POST /api/mcp

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

06

SDK's

De broncode van de TypeScript- en Python-SDK's staat in de repository. Dit zijn bronartefacten, geen gepubliceerde pakketten. Ze bevatten API-sleutel-authenticatie, veilige herpogingen, pagineerders en REST/MCP-hulpmiddelen.