Riset, terhubung.

01

Kueri riset pertama Anda

Cari di katalog dan ikuti setiap hasil kembali ke sumber ilmiahnya. Simpan kunci Anda di server, di luar kode browser.

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

Sumber ilmiah asli tetap menjadi otoritas. Urutan pencarian dan kemiripan tidak mengukur bukti klinis.

02

Autentikasi dan cakupan

Lakukan autentikasi dengan kunci API OncoRadar pada header Bearer. Setiap operasi memeriksa izin proyek dan penerimaan hukum yang berlaku.

Authorization: Bearer okr_your_api_key
Accept: application/json

Cakupan inti

Rute sumber daya

API menyediakan studi, uji klinis, sinyal, koleksi, peringatan, dan sintesis riset.

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

03

Paginasi dan kesalahan

Kirim cursor opak dari respons tanpa perubahan ke permintaan berikutnya. Gunakan pencarian baru saat filter berubah. Percobaan ulang SDK terbatas pada pembacaan yang aman dan respons yang dapat dicoba ulang.

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

04

Webhook bertanda tangan

Pengiriman dilakukan setidaknya sekali. Verifikasi tanda tangan atas byte timestamp.payload mentah, tolak timestamp di luar jendela lima menit, dan deduplikasi pengiriman secara atomik sebelum menerapkan efek. Duplikat yang valid harus mengembalikan 2xx.

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

Destinasi harus menggunakan HTTPS publik dan tidak boleh mengarah ke jaringan privat atau terreservasi. Panduan webhook di repositori mencakup contoh penerima, percobaan ulang, dan rotasi kunci berversi.

05

MCP untuk alat riset

Kirim permintaan JSON-RPC menggunakan kunci API Anda. Alat dan sumber daya difilter berdasarkan cakupan, dibatasi, serta memperhatikan lisensi. Endpoint ini tidak mengiklankan OAuth.

Versi protokol: 2025-06-18

POST /api/mcp

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

06

SDK

Sumber SDK TypeScript dan Python berada di repositori. Ini adalah artefak sumber, bukan paket yang dipublikasikan. SDK mencakup autentikasi dengan kunci API, percobaan ulang yang aman, paginator, serta helper REST/MCP.