Исследования — на связи.

01

Ваш первый исследовательский запрос

Выполните поиск в каталоге и перейдите от каждого результата к его научному источнику. Храните ключ на сервере, вне кода браузера.

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

Исходный научный источник остаётся авторитетным. Порядок поиска и сходство не измеряют уровень клинических доказательств.

02

Аутентификация и области доступа

Аутентифицируйтесь с помощью ключа API OncoRadar в заголовке Bearer. Каждая операция проверяет разрешения проекта и текущее юридическое согласие.

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, отклоняйте временные метки за пределами пятиминутного окна и атомарно устраняйте дубликаты доставки до применения эффектов. Допустимые дубликаты должны возвращать 2xx.

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

Назначения должны использовать общедоступный HTTPS и не должны разрешаться в частные или зарезервированные сети. Руководство по вебхукам в репозитории содержит примеры приёмников, сведения о повторах и версионной ротации ключей.

05

MCP для исследовательских инструментов

Отправляйте запросы JSON-RPC с помощью ключа API. Инструменты и ресурсы фильтруются по областям доступа, имеют ограничения и учитывают лицензирование. Эндпоинт не рекламирует OAuth.

Версия протокола: 2025-06-18

POST /api/mcp

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

06

SDK

Исходный код SDK для TypeScript и Python находится в репозитории. Это исходные артефакты, а не опубликованные пакеты. Они включают аутентификацию по ключу API, безопасные повторы, пагинаторы и помощники REST/MCP.