Araştırma, bağlantılı.

01

İlk araştırma sorgunuz

Katalogda arama yapın ve her sonucu bilimsel kaynağına kadar izleyin. Anahtarınızı tarayıcı kodunun dışında, sunucunuzda tutun.

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

Asıl bilimsel kaynak yetkisini korur. Arama sırası ve benzerlik, klinik kanıt düzeyini ölçmez.

02

Kimlik doğrulama ve kapsamlar

Bearer üst bilgisinde bir OncoRadar API anahtarıyla kimlik doğrulaması yapın. Her işlem proje izinlerini ve güncel yasal kabulü denetler.

Authorization: Bearer okr_your_api_key
Accept: application/json

Temel kapsamlar

Kaynak rotaları

API; çalışmaları, klinik çalışmaları, sinyalleri, koleksiyonları, uyarıları ve araştırma sentezini sunar.

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

03

Sayfalandırma ve hatalar

Bir yanıttaki opak imleci değiştirmeden sonraki isteğe aktarın. Filtreler değiştiğinde yeni bir arama kullanın. SDK yeniden denemeleri güvenli okumalar ve yeniden denenebilir yanıtlarla sınırlıdır.

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

04

İmzalı web kancaları

Teslimat en az bir kez yapılır. Ham timestamp.payload baytları üzerindeki imzayı doğrulayın, beş dakikalık pencere dışındaki zaman damgalarını reddedin ve etkileri uygulamadan önce teslimatı atomik olarak yinelenenlerden arındırın. Geçerli yinelenenler 2xx döndürmelidir.

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

Hedefler genel HTTPS kullanmalı ve özel ya da ayrılmış ağlara çözümlenmemelidir. Depodaki web kancası kılavuzunda alıcı örnekleri, yeniden denemeler ve sürümlü anahtar döndürme açıklanır.

05

Araştırma araçları için MCP

API anahtarınızı kullanarak JSON-RPC istekleri gönderin. Araçlar ve kaynaklar kapsamlara göre filtrelenir; sınırlandırılmıştır ve lisansları dikkate alır. Uç nokta OAuth'u duyurmaz.

Protokol sürümü: 2025-06-18

POST /api/mcp

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

06

SDK'ler

TypeScript ve Python SDK kaynak kodu depoda bulunur. Bunlar yayımlanmış paketler değil, kaynak kodu çıktılarıdır. API anahtarıyla kimlik doğrulama, güvenli yeniden denemeler, sayfalandırıcılar ve REST/MCP yardımcılarını içerirler.