연구를 연결합니다.

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

서명된 웹훅

전달은 최소 한 번 수행됩니다. 원시 timestamp.payload 바이트에 대한 서명을 확인하고, 5분 범위를 벗어난 타임스탬프를 거부하며, 효과를 적용하기 전에 전달을 원자적으로 중복 제거하세요. 유효한 중복 요청에는 2xx를 반환해야 합니다.

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

대상은 공개 HTTPS를 사용해야 하며 비공개 또는 예약 네트워크로 확인되어서는 안 됩니다. 저장소의 웹훅 가이드에는 수신기 예시, 재시도 및 버전별 키 교체가 설명되어 있습니다.

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 헬퍼를 포함합니다.