API de dados de saúde: o que procurar e como ler e escrever um registo de paciente numa hora

"API de saúde" abrange coisas muito diferentes: um feed HL7 v2 de um hospital, um serviço nacional de prescrição eletrónica, a exportação de um fornecedor de dispositivos vestíveis, um servidor FHIR. Se está a construir uma aplicação de saúde, uma ferramenta clínica ou um assistente de IA, o que precisa é mais restrito: um backend que armazene o registo de um paciente num formato padrão, permita ao paciente decidir quem o lê e lhe forneça uma API limpa sobre ele. Este guia diz o que procurar e mostra, com chamadas reais, como é a primeira hora na Plataforma Anpheros.

Versão técnica para programadores: API de saúde · API de dados médicos em developers.anpheros.com, com pedidos, respostas e limites. Esta página é a versão em linguagem simples.

O que uma API de dados de saúde tem de fazer

Cinco coisas separam uma API de dados de saúde utilizável de uma base de dados com HTTP à frente dela.

• Um formato padrão. HL7 FHIR R4 é o formato que hospitais, sistemas nacionais e o espaço de dados de saúde da UE utilizam. Um registo armazenado em FHIR pode ser lido por outros sistemas sem uma ponte personalizada. Um JSON proprietário não pode.
• Consentimento do paciente como um objeto de primeira classe. Quem pode ler o quê, por quanto tempo, revogável, visível para o paciente. Não uma caixa de seleção na sua própria base de dados.
• Proveniência. Cada valor indica quem o escreveu: o paciente, um profissional de saúde, um dispositivo, uma importação, um cálculo derivado. Um assistente de IA que não consegue distinguir um resultado de laboratório de uma suposição auto-relatada é perigoso.
• Uma sandbox com dados realistas. Não pode testar com pacientes reais, e não deve ter de inventar 30 pacientes sintéticos com seis meses de histórico.
• Residência de dados que pode nomear. Para utilizadores europeus, isto significa servidores na UE, sob o RGPD, com um acordo de processamento de dados.

Duas formas de acesso: REST e FHIR, os mesmos dados

A Plataforma Anpheros expõe o mesmo registo duas vezes. Uma API REST simples (/v1) para o código do produto, e FHIR R4 estrito (/fhir/R4) para tudo o que precise de comunicar com o resto do sistema de saúde. Os IDs são idênticos em ambos; cada objeto v1 carrega a sua referência fhir.

export BASE=https://platform.anpheros.com
export KEY=sk_test_…

# pacientes que o seu projeto pode ver
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# resultados de laboratório, os mais recentes primeiro
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# medicamentos ativos
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# tudo numa linha temporal
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# os mesmos dados, FHIR estrito
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

Por detrás destas chamadas estão 26 tipos de recursos FHIR (Paciente, Observação, Condição, Declaração de Medicamento, Intolerância a Alergias, Imunização, Referência de Documento, Encontro, Consentimento, Proveniência e mais), codificados com LOINC para medições, ICD-10 para condições e ATC para medicamentos.

Obter uma chave demora um minuto

A sandbox é auto-serviço e gratuita. Inicie sessão no painel em platform.anpheros.com/dashboard, clique em Obter uma chave de sandbox, e terá uma organização, um projeto de sandbox e uma chave sk_test_…. O projeto vem com a sua própria cópia de 30 pacientes sintéticos: adultos, crianças e idosos de toda a UE, com condições, medicamentos, alergias, resultados de laboratório e sinais vitais ao longo de seis meses. Altere ou elimine qualquer coisa; um reset devolve-os.

As chaves de produção (sk_live_…) destinam-se a organizações verificadas com um acordo de processamento de dados assinado. Sandbox e produção são bases de dados diferentes: uma chave de sandbox fisicamente não pode aceder a um paciente real.

O que mais está incluído

• OAuth 2.1 com PKCE e lançamento autónomo SMART on FHIR, para que uma aplicação possa pedir a uma pessoa acesso ao seu próprio registo.
• Consentimento com âmbitos, expiração e revogação, e um registo de acesso que o paciente pode ler.
• Webhooks assinados (HMAC-SHA256, retentativas com backoff) para resource.created, consent.granted, consent.revoked, document.finalized.
• Uma API de contexto de IA que constrói um resumo de um paciente com rótulos de proveniência dentro de um orçamento de tokens.
• Importação de relatórios de laboratório a partir de CSV, HL7 v2 ORU^R01 ou JSON, mapeado para LOINC.
• Resumo Internacional do Paciente ($summary) e SMART Health Links para partilha por QR.
• SDKs para Dart e TypeScript, uma referência OpenAPI em /docs e uma Declaração de Capacidade em /fhir/R4/metadata.

O guia completo, com respostas, está em developers.anpheros.com/guides/first-hour.

Perguntas frequentes

Existe uma API de saúde gratuita com que possa começar hoje?

Sim. A sandbox Anpheros é gratuita e auto-serviço: inicie sessão, obtenha uma chave e terá 30 pacientes sintéticos para ler e escrever. Os limites são 10 000 escritas de recursos por dia, 100 pacientes próprios e 250 MB de documentos por projeto.

REST ou FHIR, qual devo usar?

Use /v1 para o seu próprio código de produto: é mais simples e retorna JSON simples. Use /fhir/R4 quando outro sistema tiver de ler os dados, quando precisar de pesquisa FHIR, _history, $everything ou $summary, ou quando uma certificação o solicitar. Ambos veem o mesmo registo.

Como é tratado o consentimento do paciente?

Uma pessoa concede a uma aplicação acesso ao seu registo através de OAuth, escolhendo âmbitos e uma duração (30, 90, 180 ou 365 dias). A concessão pode ser revogada a qualquer momento, e o paciente vê todas as leituras num registo de acesso. Detalhes no modelo de consentimento.

Onde estão os dados alojados?

Na União Europeia (Cloud Run, europe-west4), com proveniência e histórico de versões em cada escrita. O uso em produção requer um acordo de processamento de dados assinado.

Quanto custa a produção?

A produção começa em 49 € por mês para 2 500 pacientes armazenados, com o primeiro mês gratuito; planos maiores custam 199 € e 799 € por mês. A sandbox continua gratuita. Veja preços.

Funciona com agentes de IA?

Sim. Existe uma API de contexto de IA com rótulos de proveniência e um orçamento de tokens, e um servidor MCP em platform.anpheros.com/mcp ao qual qualquer assistente com capacidade MCP pode ligar. Veja integração EMR com assistentes médicos de IA.