RadCommonsuma iniciativa da Laudos.AI
04 · API pública

API

Aberta, gratuita, somente leitura e versionada. CORS aberto. Sem paywall. Os slugs estáveis são um contrato público. Cada campo clínico de uma resposta carrega citação, localizador, consenso e situação de verificação.

Quickstart da APIGET /api/v1/systemsaberto
curl -s "https://radcommons.laudos.ai/api/v1/systems"
Ver documentação completa →

URL base

https://radcommons.laudos.ai

Com limite de taxa por IP. As respostas incluem cabeçalhos X-RateLimit. A API é para consultas de referência, não para coleta em massa.

MétodoEndpointDescrição
GET/api/v1/organsÓrgãos com contagem de sistemas.
GET/api/v1/systems?organ=&modality=&family=&status=&q=Listar e filtrar sistemas.
GET/api/v1/systems/{id}Um sistema com lógica, categorias, referências cruzadas, citações, vigência e linhagem de versões.
GET/api/v1/search?q=Busca de texto completo e aproximada por sistemas e categorias.
GET/POST/api/v1/context?q=&format=markdownContexto fundamentado e citado para uma IA. JSON ou markdown pronto para injetar no prompt.
GET/api/v1/changesFeed de eventos de versão. Também em RSS em /feed/changes.xml.
GET/api/v1/coverageO que está coberto e o que explicitamente ainda não está.
GET/api/v1/openapiDocumento OpenAPI 3.1.

Exemplos

# Um sistema com procedência completa
curl https://radcommons.laudos.ai/api/v1/systems/bosniak-2019

# Buscar no corpus
curl "https://radcommons.laudos.ai/api/v1/search?q=nodulo+tireoide"

# Filtrar por órgão e modalidade
curl "https://radcommons.laudos.ai/api/v1/systems?organ=Liver&modality=MRI"

# O que mudou e o que ainda não está coberto
curl https://radcommons.laudos.ai/api/v1/changes
curl https://radcommons.laudos.ai/api/v1/coverage
Para assistentes de IA

Endpoint de contexto fundamentado

/api/v1/context retorna as classificações relevantes para um achado, com critérios, conduta, risco, citações, localizadores e situação de verificação. Use format=markdown para um bloco que você cola direto no prompt. Cada linha clínica é citada e marcada como rascunho ou verificada, para que o modelo fundamente a saída e cite a fonte em vez de adivinhar.

Autenticação. Para evitar abuso, este endpoint exige uma chave de API em Authorization: Bearer be_.... Gere a sua em /account. Tem limite de taxa por IP, com cabeçalhos X-RateLimit. O restante do catálogo permanece aberto.

Quickstart da APIPOST /api/v1/contextrequer chave
curl -s -X POST "https://radcommons.laudos.ai/api/v1/context" \
  -H "Authorization: Bearer $RADCOMMONS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"liver lesion"}'
Ver documentação completa →
# Fundamentar um assistente em um achado, como markdown
curl -H "Authorization: Bearer be_..." \
  "https://radcommons.laudos.ai/api/v1/context?q=nodulo+tireoide&format=markdown"

# Puxar sistemas específicos como JSON
curl -H "Authorization: Bearer be_..." \
  "https://radcommons.laudos.ai/api/v1/context?systems=ti-rads-2017,eu-tirads"

# A partir de um achado em texto (POST)
curl -X POST https://radcommons.laudos.ai/api/v1/context \
  -H "Authorization: Bearer be_..." \
  -H "Content-Type: application/json" \
  -d '{"text":"massa de 3,2 cm na cabeca do pancreas com dilatacao biliar e dois nodulos hepaticos","format":"markdown"}'

OpenAPI

A especificação legível por máquina está em /api/v1/openapi.

API. RadCommons