Fluxo e acesso
O ciclo do exame dentro da Laudos.AI, autenticação, papéis de acesso e o modelo de segregação por instituição.
RECURSOS · DOCUMENTAÇÃO
Documentação técnica
A referência da plataforma e da API do RadCommons. O acesso completo é liberado para equipes em avaliação ou implantação.
VISÃO GERAL
O que a documentação cobre
HL7, DICOM e worklist
Mensagens suportadas, campos esperados, o caminho de retorno do laudo assinado e os cenários de integração dedicada.
O corpus por API
Consulta por termo clínico, resposta com critérios citados e versionados, autenticação por chave e limites de uso.
Para TI e DPO
Arquitetura, criptografia, subprocessadores, fluxo de dados e o racional de conformidade com LGPD e CFM 2.454/2026.
EXEMPLO · RADCOMMONS API
GET /v1/sistemas/ti-rads?versao=vigente
Authorization: Bearer <sua-chave>
{
"sistema": "ACR TI-RADS",
"versao": "2017",
"vigente": true,
"categorias": [
{ "nivel": "TR1", "criterio": "0 pontos", "conduta": "sem PAAF" },
{ "nivel": "TR5", "criterio": "7+ pontos", "conduta": "PAAF se >= 1,0 cm" }
],
"fonte": { "citacao": "Tessler FN et al. J Am Coll Radiol 2017",
"localizador": "doi:10.1016/j.jacr.2017.01.046" }
}
Resposta estruturada, citada e versionada. A documentação completa da API vive em radcommons.laudos.ai.
Acesso
AVALIAÇÃOEquipes em avaliação recebem a documentação completa com a proposta
IMPLANTAÇÃOSandbox e credenciais entram no plano de integração
RADCOMMONSDocumentação pública da API no subdomínio radcommons.laudos.ai
SOLICITAÇÃOoi@laudos.ai, assunto "Acesso à documentação"
PERGUNTAS DIRETAS
Por que a documentação completa não é pública?
Porque metade dela descreve integrações e configurações específicas de ambiente hospitalar. O que é público de verdade (o corpus e o benchmark) está aberto nos subdomínios.
Tem sandbox para testar?
Tem, na fase de implantação ou avaliação técnica. A TI recebe credenciais e um ambiente com dados de exemplo.
Documentação para implementar, não para decorar
O que uma avaliação técnica precisa receber
A documentação de plataforma descreve autenticação, papéis, segregação por instituição e o ciclo do exame. A documentação de integração detalha o caminho de entrada e retorno, mensagens, campos e ambientes aplicáveis ao projeto. A documentação de segurança apresenta fluxo de dados, criptografia, retenção e subprocessadores pertinentes à diligência.
A parte pública explica o modelo e permite preparar perguntas. A equipe libera credenciais, endpoints de ambiente e condições específicas de integração dentro de uma avaliação identificada, porque esses detalhes revelam arquitetura operacional. Esse limite protege a plataforma, mas não pode impedir a instituição de obter a informação necessária antes de aprovar o uso.
Da leitura ao sandbox
O percurso tem cinco passos. Defina o fluxo a avaliar. Receba a referência correspondente. Alinhe autenticação e dados de teste. Execute casos de sucesso e de falha. Registre os critérios de aceite.
Acesso técnico sem um caso de uso produz uma coleção de endpoints; documentação ligada ao fluxo produz uma decisão de integração.
Os testes mínimos não são apenas o caminho feliz. Incluem pedido incompleto, duplicidade, credencial inválida, indisponibilidade temporária, reenvio e reconciliação do resultado. O comportamento esperado para cada falha deve estar registrado antes da produção, junto com o dono da correção e o canal de escalonamento.
Quatro leituras, quatro responsáveis
Produto e direção clínica precisam entender autoria, revisão e governança de template. TI precisa mapear identidade, eventos, mensagens, monitoramento e contingência. O DPO precisa localizar cada dado, finalidade, retenção e subprocessador. Operação precisa saber como abrir incidente e como manter o plantão quando uma dependência falha. A documentação só está completa quando cada responsável encontra a resposta que precisa sem depender de uma reunião de memória.
PRÓXIMO PASSO
Equipe técnica avaliando a plataforma?
A documentação completa e o sandbox entram na conversa de implantação.
Conteúdo atualizado em .