Investigación conectada.

01

Tu primera consulta de investigación

Busca en el catálogo y sigue cada resultado hasta su fuente científica. Guarda la clave en tu servidor, fuera del código del navegador.

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

La fuente científica original sigue siendo la autoridad. El orden de búsqueda y la similitud no miden el nivel de evidencia clínica.

02

Autenticación y permisos

Autentícate con una clave de API de OncoRadar en la cabecera Bearer. Cada operación verifica los permisos del proyecto y la aceptación legal vigente.

Authorization: Bearer okr_your_api_key
Accept: application/json

Permisos principales

Rutas de recursos

La API ofrece estudios, ensayos clínicos, señales, colecciones, alertas y síntesis de investigación.

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

03

Paginación y errores

Pasa el cursor opaco de una respuesta sin modificarlo a la siguiente petición. Inicia otra búsqueda cuando cambien los filtros. Los SDK solo reintentan lecturas seguras y respuestas que admiten reintentos.

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

04

Webhooks firmados

La entrega ocurre al menos una vez. Verifica la firma sobre los bytes originales de timestamp.payload, rechaza marcas de tiempo fuera de una ventana de cinco minutos y elimina duplicados de forma atómica antes de aplicar efectos. Los duplicados válidos deben recibir una respuesta 2xx.

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

Los destinos deben usar HTTPS público y no pueden resolver a redes privadas o reservadas. La guía de webhooks del repositorio incluye receptores de ejemplo, reintentos y rotación de claves con versiones.

05

MCP para herramientas de investigación

Envía peticiones JSON-RPC con tu clave de API. Las herramientas y los recursos se filtran por permisos, tienen límites y respetan las licencias. El endpoint no anuncia OAuth.

Versión del protocolo: 2025-06-18

POST /api/mcp

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

06

SDKs

El código de los SDK de TypeScript y Python está en el repositorio. Son artefactos de código fuente, no paquetes publicados. Incluyen autenticación con clave de API, reintentos seguros, paginadores y herramientas REST/MCP.