https://notifications.sa-saopaulo-1.basaltic.sh. Chamadas autenticadas usam bearer token e o identificador da conta em X-Account-Id; veja Autenticação.
Tópicos e assinaturas
Gerencie assinaturas em/v1/topics/{topic_id}/subscriptions. O caminho seleciona o tópico; solicitações e respostas não o repetem. O console lista as assinaturas na aba Subscriptions do tópico.
Entregas incluem referências message e subscription, com id e crn; recursos nomeados incluem name. Liste mensagens em /v1/topics/{topic_id}/messages e consulte uma em /v1/topics/{topic_id}/messages/{message_id}. Entregas também pertencem ao tópico. O console abre a lista de tópicos, cada um com abas Subscriptions, Messages, Deliveries e Metrics. Respostas aninhadas omitem o pai conhecido.
redrive_policy.dead_letter_queue é uma referência nas respostas; solicitações aceitam UUID, nome ou CRN da fila. Excluir o destino preserva seu ID e CRN na referência e omite o nome.
Links de confirmação e cancelamento pertencem ao proprietário do destino. São separados da API autenticada de gerenciamento, que permite excluir assinaturas e reenviar confirmações.
O tópico tem nome imutável. A publicação seleciona assinaturas confirmadas cujo filtro corresponde à mensagem. O protocolo determina a interpretação do destino:
Destinos de fila e filas de falhas exigem
queue:SendMessage na fila, além da ação de Notifications. Veja Permissões do Notifications.
Aceitação e entrega
Publicar retorna HTTP202 após enfileirar de forma durável. Isso não significa recebimento pelos assinantes. Consulte o registro da mensagem para acompanhar a distribuição e os registros de entrega para resultados individuais.
Webhooks incluem assinatura HMAC. O segredo tem permissões separadas de leitura e rotação; consultar a assinatura não concede acesso ao segredo.
Métricas
Abra Metrics no tópico para acompanhar publicações, resultados, taxa de sucesso, latência e pendências. Os gráficos usam os controles de tempo e a API Telemetry das métricas de instância. Use Deliveries para investigar falhas individuais; métricas não contêm URLs de destino nem corpos. As séries são amostradas a cada 30 segundos. Filtre portopic_id e region em Telemetry. Séries de entrega também incluem protocol (email, https, http ou queue). A leitura exige telemetry:ReadMetrics na conta e região selecionadas.
Use
rate em contadores. A taxa de sucesso divide entregas bem-sucedidas por resultados definitivos. A latência média divide a taxa da soma de duração pela taxa da contagem. Não há valor quando o denominador é zero. Contadores começam na implantação das métricas e persistem após remover o histórico. Não há preenchimento retroativo. Amostras ausentes representam falta de observação, não atividade zero.
Criar um tópico
Name a publishing destination and choose delivery defaults.
Criar uma assinatura
Connect email, webhooks, and queues.
Políticas de filtro
Match attributes with worked examples and operator rules.
Publicar mensagens
Send attributed events and follow fan-out.
Entregas e falhas
Verify webhooks, configure retries, and retain failed deliveries.
Permissões
IAM actions and cross-service grants.