Afeta
Equipes que integram com o Midaz e precisam reagir a eventos do ledger — conciliação, notificações, projeções downstream e analytics — em vez de fazer polling na API REST. Isso inclui tanto deploys self-hosted que operam seu próprio broker quanto integradores externos / SaaS que consomem eventos por uma borda gerenciada. Esta é uma mudança de nova documentação. Ela descreve recursos de entrega de eventos existentes; nenhum comportamento novo de produto é introduzido.
O que mudou
Um novo guia de referência, Receber eventos do Midaz, já está disponível. Ele cobre as duas formas aceitas de consumir o stream de eventos do Midaz e como escolher entre elas.
RabbitMQ direto
Vincule sua própria fila direto às topic exchanges AMQP (0-9-1) do Midaz. Melhor para deploys self-hosted ou co-localizados em que você opera o broker do Midaz. O guia documenta as exchanges relevantes e as flags de ambiente self-hosted que as habilitam.Streaming Hub
Crie subscriptions pelo serviço gerenciado de fan-out da Lerian por uma API REST de control plane, com entrega via Webhook, Pull (HTTP), SQS, RabbitMQ ou EventBridge. Melhor para integradores externos / SaaS que querem acoplamento fraco e subscriptions por tenant sem operar um broker.Como escolher
O Midaz publica cada evento de domínio nos dois transportes em paralelo, então as duas superfícies expõem os mesmos eventos subjacentes. O guia inclui uma comparação lado a lado (transporte, ao que você se conecta, acoplamento e cenários mais adequados) para ajudar você a escolher a abordagem certa.Impacto
Esta é uma mudança informativa. Nenhum endpoint, schema de evento ou comportamento de entrega muda. Nada para migrar e nenhuma ação é necessária. Classificação: Informativo. A mudança é a disponibilidade de uma referência consolidada para receber eventos do Midaz.
O que você precisa fazer
1
Leia Receber eventos do Midaz para entender as duas abordagens de relance.
2
Se você roda seu próprio broker do Midaz, revise a seção RabbitMQ direto e as flags de ambiente self-hosted.
3
Se você integra como consumidor externo, revise a seção Streaming Hub e escolha seu transporte de entrega.