As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Gerenciando assinaturas FHIR em AWS HealthLake
<a name="managing-fhir-subscriptions"></a>

AWS HealthLake suporta assinaturas FHIR, permitindo que você receba notificações em tempo real quando ocorrerem alterações específicas nos dados de saúde. Esse recurso implementa o modelo de assinatura baseado em tópicos do FHIR R5 Backport, fornecendo maior escalabilidade e flexibilidade em relação ao modelo de assinatura tradicional do FHIR R4.

Com as assinaturas do FHIR, você pode criar aplicativos de saúde orientados a eventos que respondem imediatamente às mudanças nos dados clínicos, permitindo intervenções oportunas, fluxos de trabalho automatizados e coordenação aprimorada do atendimento.

**Topics**
+ [Como funcionam as assinaturas do FHIR](#managing-fhir-subs-how-subs-work)
+ [Componentes principais](#managing-fhir-subs-components)
+ [Práticas recomendadas](#managing-fhir-subs-best-practices)
+ [Ciclo de vida da assinatura](managing-fhir-subscriptions-lifecycle.md)
+ [Criando uma assinatura](managing-fhir-subscriptions-create.md)
+ [Pesquisando assinaturas](managing-fhir-subscriptions-searching.md)
+ [Filtrando notificações](managing-fhir-subscriptions-filter-notif.md)

## Como funcionam as assinaturas do FHIR
<a name="managing-fhir-subs-how-subs-work"></a>

As assinaturas do FHIR HealthLake operam em um modelo baseado em tópicos, onde: 

1. **Crie tópicos para definir eventos**: Crie tópicos de assinatura que especificam eventos que podem acionar notificações

1. **Você se inscreve**: Crie assinaturas para esses tópicos com critérios de filtragem específicos

1. **HealthLake monitores**: o serviço monitora continuamente os eventos que atendem aos seus critérios

1. **Notificações entregues**: eventos CWhen correspondentes ocorrem, HealthLake entrega notificações por meio do canal escolhido

## Componentes principais
<a name="managing-fhir-subs-components"></a>

As assinaturas do FHIR consistem nos seguintes componentes. 

### Tópicos de assinatura
<a name="managing-fhir-subs-components-sub-topic"></a>

Os tópicos de assinatura são a base do sistema de notificação e definem:
+ **Eventos de gatilho**: o que muda as notificações acionadas (por exemplo: criação de recursos, atualizações, exclusões)
+ **Filtros disponíveis**: quais opções de filtragem estão disponíveis para os assinantes
+ **Conteúdo da notificação**: quais dados estão incluídos nas notificações

A tabela a seguir lista os tipos de tópicos comuns.


| Tipo de evento | Description | Casos de uso comuns | 
| --- | --- | --- | 
| Criação de recursos | Acionado quando os recursos são criados | Novo registro de pacientes, nova observação registrada | 
| Atualizações de recursos | Acionado quando os recursos são modificados | Mudanças de status, atualizações clínicas | 
| Exclusão de recursos | Acionado quando os recursos são excluídos | Rastreamento de auditoria e conformidade | 

### Assinaturas
<a name="managing-fhir-subs-components-subs"></a>

Uma Assinatura é sua solicitação para receber notificações de eventos específicos definidos por um Tópico de Assinatura. Cada assinatura inclui:
+ **Referência do tópico**: especifica em qual tópico de assinatura você está se inscrevendo
+ **Filtros**: critérios para selecionar quais eventos geram notificações
+ **Configuração do canal**: onde e como as notificações devem ser entregues
+ **Preferências de carga útil**: qual nível de detalhe deve ser incluído nas notificações

### Canais de notificação
<a name="managing-fhir-subs-components-notif-chan"></a>

HealthLake suporta os seguintes canais de notificação:


| Tipo de canal | Casos de uso | 
| --- | --- | 
| EventBridge | Integrações corporativas, fluxos de trabalho sem servidor, orquestração entre serviços AWS  | 
| REST Hook | Notificações diretas de endpoints, integração de sistemas de terceiros | 

### Cargas de notificação
<a name="managing-fhir-subs-components-notif-payloads"></a>

Escolha o tipo de carga útil adequado com base em suas necessidades:


| Tipo de carga | Description | Considerações sobre segurança | 
| --- | --- | --- | 
| Somente ID | Contém somente identificadores de recursos | Exposição mínima ao PHI | 
| Recurso completo | Contém conteúdo completo de recursos com um tamanho máximo de 256 KB. Se o tamanho for maior que 256 KB, ele voltará para somente ID  | Contém PHI; verifique o manuseio seguro | 

## Práticas recomendadas
<a name="managing-fhir-subs-best-practices"></a>

Otimização de desempenho
+ **Use filtros focados**: restrinja seus critérios para receber apenas notificações essenciais
+ **Escolha os tipos de carga útil apropriados**: use cargas somente de ID quando possível para melhorar o desempenho
+ **Implemente receptores eficientes**: garanta que os receptores de notificações processem mensagens rapidamente

Considerações sobre segurança
+ **Endpoints seguros**: implemente a autenticação adequada para endpoints REST Hook
+ **Proteção de PHI**: tenha cuidado com cargas de recursos completos, pois elas contêm PHI
+ **Controle de acesso**: restrinja a criação de assinaturas somente a usuários autorizados

Excelência operacional
+ **Defina datas de término apropriadas**: use datas de término para assinaturas temporárias
+ **Monitore o status da assinatura**: verifique regularmente o status de suas assinaturas
+ **Implemente o tratamento de erros**: projete seus aplicativos para lidar com falhas na entrega de notificações