https://notifications.sa-saopaulo-1.basaltic.sh. Las llamadas autenticadas usan bearer token y el identificador de la cuenta en X-Account-Id; consulte Autenticación.
Temas y suscripciones
Administre suscripciones en/v1/topics/{topic_id}/subscriptions. La ruta selecciona el tema; las solicitudes y respuestas no lo repiten. La consola lista las suscripciones en la pestaña Subscriptions del tema.
Las entregas incluyen referencias message y subscription, con id y crn; los recursos con nombre incluyen name. Liste mensajes en /v1/topics/{topic_id}/messages y consulte uno en /v1/topics/{topic_id}/messages/{message_id}. Las entregas también pertenecen al tema. La consola abre la lista de temas, cada uno con pestañas Subscriptions, Messages, Deliveries y Metrics. Las respuestas anidadas omiten el padre conocido.
redrive_policy.dead_letter_queue es una referencia en las respuestas; las solicitudes aceptan UUID, nombre o CRN de la cola. Eliminar el destino conserva su ID y CRN en la referencia y omite el nombre.
Los enlaces de confirmación y cancelación pertenecen al propietario del destino. Son independientes de la API autenticada de administración, que permite eliminar suscripciones y reenviar confirmaciones.
El tema tiene un nombre inmutable. La publicación selecciona suscripciones confirmadas cuyo filtro coincide con el mensaje. El protocolo determina la interpretación del destino:
Los destinos de cola y las colas de fallos exigen
queue:SendMessage en la cola, además de la acción de Notifications. Consulte Permisos de Notifications.
Aceptación y entrega
Publicar devuelve HTTP202 tras encolar de forma duradera. Esto no significa recepción por los suscriptores. Consulte el registro del mensaje para seguir la distribución y los registros de entrega para los resultados individuales.
Los webhooks incluyen firma HMAC. El secreto tiene permisos separados de lectura y rotación; consultar la suscripción no concede acceso al secreto.
Métricas
Abra Metrics en el tema para seguir publicaciones, resultados, tasa de éxito, latencia y pendientes. Los gráficos usan los controles de tiempo y la API Telemetry de las métricas de instancia. Use Deliveries para investigar fallos individuales; las métricas no contienen URL de destino ni cuerpos. Las series se muestrean cada 30 segundos. Filtre portopic_id y region en Telemetry. Las series de entrega también incluyen protocol (email, https, http o queue). La lectura exige telemetry:ReadMetrics en la cuenta y región seleccionadas.
Use
rate en contadores. La tasa de éxito divide entregas correctas por resultados definitivos. La latencia media divide la tasa de la suma de duración por la tasa del recuento. No hay valor cuando el denominador es cero. Los contadores empiezan al desplegar las métricas y persisten tras retirar el historial. No hay relleno retroactivo. Las muestras ausentes representan falta de observación, no actividad cero.
Crear un tema
Name a publishing destination and choose delivery defaults.
Crear una suscripción
Connect email, webhooks, and queues.
Políticas de filtro
Match attributes with worked examples and operator rules.
Publicar mensajes
Send attributed events and follow fan-out.
Entregas y fallos
Verify webhooks, configure retries, and retain failed deliveries.
Permisos
IAM actions and cross-service grants.