Ricerca connessa.

01

La Sua prima query di ricerca

Cerchi nel catalogo e segua ogni risultato fino alla relativa fonte scientifica. Conservi la chiave sul Suo server, al di fuori del codice del browser.

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

La fonte scientifica originale resta l'autorità. L'ordine di ricerca e la similarità non misurano l'evidenza clinica.

02

Autenticazione e ambiti

Si autentichi con una chiave API OncoRadar nell'intestazione Bearer. Ogni operazione verifica le autorizzazioni del progetto e l'accettazione legale corrente.

Authorization: Bearer okr_your_api_key
Accept: application/json

Ambiti principali

Route delle risorse

L'API espone studi, studi clinici, segnali, raccolte, avvisi e sintesi della ricerca.

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

03

Paginazione ed errori

Passi il cursore opaco di una risposta invariato alla richiesta successiva. Avvii una nuova ricerca quando cambiano i filtri. I retry degli SDK sono limitati alle letture sicure e alle risposte ritentabili.

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

04

Webhook firmati

La consegna avviene almeno una volta. Verifichi la firma sui byte grezzi di timestamp.payload, rifiuti i timestamp al di fuori di una finestra di cinque minuti e deduplichi atomicamente la consegna prima di applicare gli effetti. I duplicati validi devono restituire 2xx.

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

Le destinazioni devono usare HTTPS pubblico e non devono risolversi in reti private o riservate. La guida ai webhook nel repository illustra esempi di ricevitori, retry e rotazione delle chiavi con versionamento.

05

MCP per strumenti di ricerca

Invii richieste JSON-RPC usando la Sua chiave API. Strumenti e risorse sono filtrati in base agli ambiti, delimitati e compatibili con le licenze. L'endpoint non pubblicizza OAuth.

Versione del protocollo: 2025-06-18

POST /api/mcp

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

06

SDK

Il codice sorgente degli SDK TypeScript e Python si trova nel repository. Sono artefatti sorgente, non pacchetti pubblicati. Includono autenticazione con chiave API, retry sicuri, paginatori e helper REST/MCP.