La recherche, connectée.

01

Votre première requête de recherche

Recherchez dans le catalogue et suivez chaque résultat jusqu’à sa source scientifique. Conservez votre clé sur votre serveur, hors du code du navigateur.

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

La source scientifique originale reste l’autorité. L’ordre de recherche et la similarité ne mesurent pas le niveau de preuve clinique.

02

Authentification et champs d’autorisation

Authentifiez-vous avec une clé API OncoRadar dans l’en-tête Bearer. Chaque opération vérifie les autorisations du projet et l’acceptation juridique en vigueur.

Authorization: Bearer okr_your_api_key
Accept: application/json

Champs d’autorisation principaux

Routes de ressources

L’API expose des études, des essais cliniques, des signaux, des collections, des alertes et une synthèse de recherche.

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

03

Pagination et erreurs

Transmettez le curseur opaque d’une réponse, sans le modifier, dans la requête suivante. Effectuez une nouvelle recherche lorsque les filtres changent. Les nouvelles tentatives du SDK se limitent aux lectures sûres et aux réponses pouvant faire l’objet d’une nouvelle tentative.

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

04

Webhooks signés

La livraison a lieu au moins une fois. Vérifiez la signature sur les octets bruts timestamp.payload, rejetez les horodatages situés hors d’une fenêtre de cinq minutes et dédupliquez atomiquement la livraison avant d’appliquer les effets. Les doublons valides doivent renvoyer 2xx.

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

Les destinations doivent utiliser HTTPS public et ne doivent pas se résoudre vers des réseaux privés ou réservés. Le guide des webhooks du dépôt présente des exemples de récepteurs, les nouvelles tentatives et la rotation versionnée des clés.

05

MCP pour les outils de recherche

Envoyez des requêtes JSON-RPC avec votre clé API. Les outils et les ressources sont filtrés selon les champs d’autorisation, encadrés et adaptés aux licences. Le point de terminaison n’annonce pas OAuth.

Version du protocole : 2025-06-18

POST /api/mcp

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

06

SDK

Le code source des SDK TypeScript et Python se trouve dans le dépôt. Il s’agit d’artefacts sources, et non de paquets publiés. Ils incluent l’authentification par clé API, les nouvelles tentatives sûres, les paginateurs et les utilitaires REST/MCP.