Pesquisa conectada.

01

Sua primeira consulta de pesquisa

Pesquise no catálogo e acompanhe cada resultado até sua fonte científica. Mantenha sua chave no servidor, fora do código do navegador.

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

A fonte científica original continua sendo a autoridade. A ordem da pesquisa e a similaridade não medem a evidência clínica.

02

Autenticação e escopos

Autentique-se com uma chave de API do OncoRadar no cabeçalho Bearer. Cada operação verifica as permissões do projeto e a aceitação legal vigente.

Authorization: Bearer okr_your_api_key
Accept: application/json

Escopos principais

Rotas de recursos

A API disponibiliza estudos, ensaios clínicos, sinais, coleções, alertas e síntese de pesquisa.

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

03

Paginação e erros

Envie o cursor opaco de uma resposta, sem alterações, na próxima solicitação. Inicie uma nova pesquisa quando os filtros mudarem. As tentativas automáticas dos SDKs são limitadas a leituras seguras e respostas que podem ser repetidas.

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

04

Webhooks assinados

A entrega ocorre pelo menos uma vez. Verifique a assinatura sobre os bytes brutos de timestamp.payload, rejeite marcas de tempo fora de uma janela de cinco minutos e deduplicate atomicamente a entrega antes de aplicar efeitos. Duplicatas válidas devem retornar 2xx.

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

Os destinos devem usar HTTPS público e não podem resolver para redes privadas ou reservadas. O guia de webhooks do repositório apresenta exemplos de receptores, novas tentativas e rotação de chaves versionada.

05

MCP para ferramentas de pesquisa

Envie solicitações JSON-RPC usando sua chave de API. Ferramentas e recursos são filtrados por escopos, têm limites definidos e consideram o licenciamento. O endpoint não anuncia OAuth.

Versão do protocolo: 2025-06-18

POST /api/mcp

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

06

SDKs

O código-fonte dos SDKs de TypeScript e Python está no repositório. São artefatos de código-fonte, não pacotes publicados. Incluem autenticação por chave de API, novas tentativas seguras, paginadores e auxiliares REST/MCP.