# API de EHR e API de registos médicos

> Como as aplicações leem e escrevem registos de saúde através de FHIR: APIs de EHR hospitalares vs. uma API de registos controlada pelo paciente, o que cada uma abrange, GDPR e alojamento na UE, e HIPAA (BAA e região dos EUA a pedido).

Source: https://developers.anpheros.com/pt/guides/ehr-api

**Uma API de EHR (API de registo eletrónico de saúde, também chamada API de EMR ou API de registos médicos) permite que o software leia e escreva o registo de saúde de um paciente — dados demográficos, diagnósticos, medicamentos, alergias, resultados, documentos — através da Internet, geralmente como recursos HL7 FHIR R4 por trás de OAuth.** Fornecedores de EHR hospitalares como Epic e Oracle Health expõem APIs FHIR aos seus próprios registos, e nos EUA os EHRs certificados devem oferecer acesso ao paciente através de tais APIs. Anpheros é uma peça diferente: uma API de registos médicos controlada pelo paciente na qual qualquer aplicação pode ser construída, onde clínicas, laboratórios, aplicações e dispositivos escrevem num registo FHIR R4 por pessoa e o acesso necessita do consentimento dessa pessoa.

<!-- visual:ehr-stack -->

## Dois tipos de API de registos médicos

| | API de EHR Hospitalar (ex. Epic, Oracle Health) | API de registos controlados pelo paciente (Anpheros) |
|---|---|---|
| De quem são os registos | Um hospital ou sistema de saúde | Uma pessoa, de todas as fontes que escrevem nele |
| Como obter acesso | Registo de aplicação junto do fornecedor, muitas vezes por sistema de saúde | Chave de sandbox de autoatendimento; produção após um acordo de processamento de dados |
| Quem autoriza | O sistema de saúde e o paciente para aplicações de acesso do paciente | O paciente (consentimento OAuth) ou a sua organização para os pacientes que cria |
| Escrita de dados | Limitada, depende do fornecedor | Criar, atualizar e eliminar os seus próprios recursos; proveniência em cada escrita |
| Padrão | FHIR R4 (US Core nos EUA) | FHIR R4 mais uma API REST mais simples |
| Ideal para | Ler o que um hospital registou | Construir um produto com base num registo que as pessoas transportam consigo |

Funcionam em conjunto: uma aplicação pode ler um EHR hospitalar através da sua API e manter o registo próprio da pessoa no Anpheros, com o hospital como fonte registada.

## O que a API de registos Anpheros abrange

| Parte do registo | Recurso FHIR | REST v1 |
|---|---|---|
| Demografia | `Patient` | `/v1/patients` |
| Diagnósticos | `Condition` (ICD-10) | `/v1/patients/{id}/conditions` |
| Medicamentos | `MedicationStatement` (ATC) | `/v1/patients/{id}/medications` |
| Resultados e sinais vitais | `Observation` (LOINC) | `/v1/patients/{id}/observations`, importação de laboratório |
| Documentos | `DocumentReference` | `/v1/patients/{id}/documents` |
| Tudo, por ordem | `Patient/$everything` | `/v1/patients/{id}/timeline` |
| Um resumo partilhável | `Patient/$summary` (IPS) | — |

```bash
# one patient's active problems, as FHIR
curl "https://platform.anpheros.com/fhir/R4/Condition?patient=$PID&clinical-status=active" \
  -H "Authorization: Bearer $KEY"
```

## Conformidade e localização de dados

- **RGPD e a UE:** os dados são armazenados e processados na União Europeia (Google Cloud `europe-west4`, Países Baixos); cada leitura e escrita é registada e visível para o paciente; o acesso por outras aplicações requer o consentimento do paciente.
- **HIPAA:** A Anpheros atua como Business Associate para clínicas nos EUA. Um acordo de Business Associate (BAA) e uma região de dados dos EUA estão disponíveis mediante solicitação para clientes de produção; a produção para dados de pacientes dos EUA abre após a assinatura do BAA. Até lá, não armazene informações de saúde protegidas que se enquadrem na HIPAA na Anpheros.

## Perguntas frequentes

### O que é uma API de EHR?
Uma interface através da qual o software lê e escreve registos de saúde eletrónicos, geralmente recursos HL7 FHIR R4 como Patient, Condition, MedicationStatement e Observation, autorizados com OAuth e SMART on FHIR.

### Qual é a diferença entre uma API de EHR e uma API de EMR?
Na prática, os termos são usados de forma intercambiável. EMR significa tradicionalmente o registo de uma prática; EHR, um registo destinado a ser partilhado entre prestadores de cuidados. Ambos são geralmente expostos como APIs FHIR atualmente.

### Posso aceder ao EHR de um hospital através do Anpheros?
Não. O Anpheros não se liga a EHRs de hospitais por si só. A sua aplicação pode ler a API FHIR de um hospital separadamente e armazenar o que a pessoa permite no seu registo Anpheros.

### Existe uma API gratuita de registos médicos para programadores?
Sim. A sandbox do Anpheros é gratuita, com 30 pacientes sintéticos sobre FHIR R4 e REST; a produção começa em €99 por mês.

### O Anpheros está em conformidade com a HIPAA?
O Anpheros atua como um **Business Associate** para clínicas nos EUA: um Business Associate Agreement (BAA) e uma região de dados dos EUA estão disponíveis mediante pedido para clientes de produção, para além do programa de segurança escrito (análise de risco, políticas, registo de auditoria, encriptação, backups). Pergunte antes de armazenar informações de saúde protegidas: a produção abre após a assinatura do BAA. Ver [Segurança, privacidade e residência de dados](https://developers.anpheros.com/pt/guides/security).

<!-- visual:cta-ehr -->

## Relacionado

- [API de Saúde](https://developers.anpheros.com/pt/guides/healthcare-api)
- [Registo médico do paciente](https://developers.anpheros.com/pt/guides/patient-medical-record)
- [API de dados longitudinais do paciente](https://developers.anpheros.com/pt/guides/longitudinal-patient-data-api)
- [Plataforma de consentimento do paciente para aplicações de saúde](https://developers.anpheros.com/pt/guides/patient-consent-platform)
- [Segurança, privacidade e residência de dados](https://developers.anpheros.com/pt/guides/security)
- [Como integrar sistemas de clínica com um backend FHIR](https://developers.anpheros.com/pt/guides/integrate-clinic-systems-fhir)