LHB Event Bus

A lightweight event routing service. Apps publish messages to topics, and subscribers receive them via webhook — no external queue infrastructure required.

Your App POST /publish pgmq Queue Webhook Your Service

How it works

1

Register your app

Create an app to get an API key. This key identifies your service and is used to authenticate every request.

2

Subscribe to topics

Register webhook URLs for the topics you care about (e.g. order.created, payment.failed). Events published to those topics are delivered to your endpoint.

3

Publish events

Send events to any topic. They're enqueued in pgmq and fanned out to all subscribers automatically.

4

Check delivery

Each event tracks its delivery status — delivered, failed, or partial. Visit the Dashboard to monitor your topics.

API

Method Path Auth Description
GET /health No Health check
GET /doc No OpenAPI JSON spec
GET /ui No Swagger UI
POST /admin/apps Admin Create app (returns API key)
GET /admin/apps Admin List all apps
DELETE /admin/apps/:id Admin Delete an app
POST /topics/:topic/subscribers Yes Subscribe a webhook to a topic
GET /topics/:topic/subscribers Yes List subscribers for a topic
DELETE /subscribers/:id Yes Remove a subscriber
POST /publish Yes Publish an event to a topic