Documentação das APIs

Uma chave no cabeçalho, JSON na ida e na volta. Os exemplos desta página usam a chave fictícia SUA_CHAVE e respostas ilustrativas.

Pedir chave de teste

curl -s -X POST "https://api.clinicals.medraph.ia.br/v1/hipoteses" \
  -H "X-API-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"sintomas":["cefaleia","fotofobia","náusea"],"limite_doencas":5}'

const resposta = await fetch('https://api.clinicals.medraph.ia.br/v1/hipoteses', {
  method: 'POST',
  headers: { 'X-API-Key': 'SUA_CHAVE', 'Content-Type': 'application/json' },
  body: JSON.stringify({"sintomas":["cefaleia","fotofobia","náusea"],"limite_doencas":5}),
});
const dados = await resposta.json();

import requests

resposta = requests.post(
    "https://api.clinicals.medraph.ia.br/v1/hipoteses",
    headers={"X-API-Key": "SUA_CHAVE"},
    json={"sintomas":["cefaleia","fotofobia","náusea"],"limite_doencas":5},
)
dados = resposta.json()

Autenticação

Toda chamada leva a sua chave no cabeçalho X-API-Key. Cada cliente tem a própria chave, e ela pode ser trocada a qualquer momento.

Formatos

Requisições e respostas em JSON (UTF-8). As rotas de bula também devolvem PDF e Markdown. Datas no formato AAAA-MM-DD.

Limites

O limite de chamadas é combinado por cliente, conforme o volume estimado. Fale com a gente para definir o seu.

Erros

Código	O que significa
`400`	Parâmetro ausente ou inválido. A resposta diz qual e, quando há uma lista fechada, quais valores valem.
`401`	Chave ausente ou inválida.
`404`	Conceito, registro ou código não encontrado.
`500`	Erro do nosso lado. Repita a chamada; se continuar, fale com a gente.

Endereço basehttps://api.clinicals.medraph.ia.br

Endereço basehttps://apianvisa.medraph.ia.br

MedRaphAI Clinicals API

Dados clínicos prontos para o seu produto

Hipóteses diagnósticas
Envie os sintomas e receba, numa chamada só, as doenças candidatas com remédios, exames e conduta.
POST/v1/hipotesesGET/v1/hipoteses
Anamnese sem IA generativa
A fala do paciente vira sintomas, duração, intensidade e as próximas perguntas, por regras fixas.
POST/v1/anamnese
Respostas clínicas com citação
Pergunta em texto livre, resposta curta e os trechos que a sustentam.
POST/v1/responderGET/v1/responder
Leitura de texto clínico
Acha doenças, sintomas e remédios num texto livre, com negação, e traz as fichas e a posologia.
POST/v1/textoGET/v1/texto
Interações medicamentosas
De 2 a 10 remédios, por nome comercial ou princípio ativo: pares com interação, gravidade e manejo.
POST/v1/interacoesGET/v1/interacoes
Fichas e busca de conceitos
Busque doença, sintoma, medicamento ou procedimento pelo nome e abra a ficha completa.
GET/v1/buscaGET/v1/conceitos/{id}
Protocolos clínicos oficiais
O texto integral de um protocolo clínico oficial, pronto para leitura ou para o contexto de um agente.
GET/v1/protocolos/{numero}
Literatura científica
Os artigos científicos sobre um conceito, com a relação que cada um afirma.
GET/v1/artigos

API do Bulário ANVISA

O bulário da ANVISA como API

Busca de medicamentos
Busca no catálogo da ANVISA que entende erro de digitação: "dipirna" acha dipirona.
GET/medicamentosGET/medicamentos/{registro}
Bulas de todos os laboratórios
As bulas de todos os laboratórios que fabricam o produto buscado, com o link do PDF.
GET/bulas
Bula em Markdown, por seções
A bula em texto, com as tabelas preservadas, e só com as seções que o seu agente precisa.
GET/bulas/{registro}/md
PDF original da bula
O arquivo oficial da bula, do paciente ou do profissional, direto pelo número do registro.
GET/bulas/{registro}/pdf
Apresentação pelo código de barras
Leia o código de barras e receba a apresentação, o preço máximo ao consumidor e a bula.
GET/apresentacoes/{codigo}

Servidores MCP

Para clientes MCP, no padrão streamable-http, com a mesma chave.

MCPstreamable-httpBusca clínicaBusca de conteúdo médico com os trechos já recortados e citáveis.
MCPstreamable-httpCódigos de saúdeCID-10, CID-11, SIGTAP e TUSS por nome, código ou sinônimo.
MCPstreamable-httpPrescriçãoMonta a prescrição a partir dos trechos da base, com a origem de cada campo.
MCPstreamable-httpInteraçõesCheca de 2 a 10 remédios e devolve gravidade, efeito e manejo.

Falta alguma rota para o seu caso?

Conte o que o seu produto precisa. Isso orienta o que construímos em seguida.

Fale com a gente