让研究互联。

01

您的首次研究查询

搜索目录，并将每条结果追溯至其科学来源。请将密钥保存在服务器上，勿置于浏览器代码中。

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

原始科学来源仍是权威依据。搜索顺序和相似度不用于衡量临床证据。

02

身份验证与作用域

在 Bearer 标头中使用 OncoRadar API 密钥进行身份验证。每项操作都会检查项目权限及当前法律条款的接受状态。

Authorization: Bearer okr_your_api_key
Accept: application/json

核心作用域

资源路由

API 提供研究、临床试验、信号、集合、提醒和研究综合。

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

03

分页与错误

将响应中的不透明游标原样传递至下一次请求。筛选条件变化时，请发起新的搜索。SDK 重试仅限于安全读取和可重试响应。

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

04

签名 Webhook

交付至少进行一次。请验证原始 timestamp.payload 字节上的签名，拒绝时间戳超出五分钟窗口的请求，并在应用效果前以原子方式去重交付。有效的重复交付应返回 2xx。

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

目标地址必须使用公共 HTTPS，且不得解析到私有或保留网络。代码仓库中的 Webhook 指南涵盖接收方示例、重试和版本化密钥轮换。

05

用于研究工具的 MCP

使用您的 API 密钥发送 JSON-RPC 请求。工具和资源会按作用域进行筛选，并受边界及许可条件约束。该端点不提供 OAuth 宣告。

协议版本：2025-06-18

POST /api/mcp

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

06

SDK

TypeScript 和 Python SDK 源代码位于代码仓库中。这些是源代码产物，并非已发布的软件包。其中包含 API 密钥身份验证、安全重试、分页器以及 REST/MCP 辅助工具。