研究を、つなぐ。

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

配信は少なくとも1回行われます。rawのtimestamp.payloadバイトに対する署名を検証し、5分間のウィンドウ外のタイムスタンプを拒否してから、効果を適用する前に配信をアトミックに重複排除します。有効な重複には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ヘルパーが含まれます。