Interfaces¶
Databús exposes four external interface surfaces and serves all of them from behind a single Traefik reverse proxy in production.
| Page | Surface | Audience |
|---|---|---|
| REST API | HTTP/JSON — control plane and schedule data | Frontends, dispatchers, simulators |
| MQTT telemetry | MQTT — vehicle telemetry ingestion | On-board equipment, simulators |
| AMQP events | AMQP — domain event bus | Internal services, future consumers |
| GTFS Realtime feeds | Protobuf/JSON — live transit data | Passenger apps, agencies, aggregators |
| URL directory | Subdomains and ports reference | Operators, integrators |
Quick orientation:
- To send vehicle position data → MQTT telemetry
- To create or update a run → REST API
- To consume live vehicle locations → GTFS Realtime feeds
- To find a service URL → URL directory