# ARD Eventhub

> Echtzeit-Metadaten für Hörfunksendungen der ARD verteilen.

## Docs

- [ARD Eventhub](https://swrlab.github.io/ard-eventhub): Echtzeit-Metadaten für Hörfunksendungen der ARD verteilen.
- [KI-kompatible Dokumentation](https://swrlab.github.io/ard-eventhub/ai-ready): Diese Docs für LLMs und Coding-Agenten nutzen — Markdown-URLs, Copy as Markdown und llms.txt.
- [OpenAPI](https://swrlab.github.io/ard-eventhub/openapi): OpenAPI-Spezifikation und API-Referenz.

## Benutzer-Guides

- [Migration auf Eventhub v3](https://swrlab.github.io/ard-eventhub/user/migration-v3): Breaking Changes und Anpassungen für Publisher und Subscriber bei Eventhub 3.0.
- [Schnellstart](https://swrlab.github.io/ard-eventhub/user/quickstart): Leitfaden für Publisher und Subscriber im ARD Eventhub.
- [Bilder](https://swrlab.github.io/ard-eventhub/user/images): Infos zu Covern und Bildern.
- [Authentifizierung](https://swrlab.github.io/ard-eventhub/user/authentication): Login und Token-Austausch für die Eventhub-API.
- [Event-Types](https://swrlab.github.io/ard-eventhub/user/event-types): Unterstützte Optionen im ARD Eventhub.
- [Track-Types](https://swrlab.github.io/ard-eventhub/user/track-types): Für die Subscriber-Darstellung.

## Integrationen

- [Plugins](https://swrlab.github.io/ard-eventhub/plugins): Überblick über verfügbare Eventhub-Plugins.
- [ARD Sounds](https://swrlab.github.io/ard-eventhub/plugins/ard-sounds): Zentrale Weitergabe der Titel an ARD Sounds.
- [DTS Xperi](https://swrlab.github.io/ard-eventhub/plugins/dts-xperi): Verwendung des DTS Xperi Plugins im Eventhub.
- [Radioplayer](https://swrlab.github.io/ard-eventhub/plugins/radioplayer): Verwendung des Radioplayer Plugins im Eventhub.

## IDs

- [Allgemeine IDs](https://swrlab.github.io/ard-eventhub/ids/common-ids): Gemeinsame nächtliche Sendungen und Firehose-Topics.
- [External IDs](https://swrlab.github.io/ard-eventhub/ids/external-ids): Anforderungen an externalId / CRID für Livestreams.

## Admin/ Betrieb

- [Benutzer](https://swrlab.github.io/ard-eventhub/admin/users): Benutzerverwaltung für Admins.

## Context/ RFCs

- [RFC 0001 — Eventhub: Current State](https://swrlab.github.io/ard-eventhub/context-rfc/eventhub-current-state): Retrospective RFC: what ARD Eventhub is today, how it got here, and where the rough edges are.
- [RFC 0002 — Eventhub v3: eventhub-connect](https://swrlab.github.io/ard-eventhub/context-rfc/eventhub-v3-connect): Design RFC: moving ingest, validation and fan-out onto a three-node NATS/MQTT cluster inside the ARD CN.

## Development Guides

- [Namenskonventionen](https://swrlab.github.io/ard-eventhub/development/naming): Konsistente Namen für Pub/Sub und Services.
- [Secrets](https://swrlab.github.io/ard-eventhub/development/secrets): Verwaltung von Secrets und Konfigurationsdateien.
- [Stages](https://swrlab.github.io/ard-eventhub/development/stages): Stage-Werte und Deployment-Umgebungen.

## Api

- [ARD Eventhub](https://swrlab.github.io/ard-eventhub/api)

### Auth

- [Request password reset email](https://swrlab.github.io/ard-eventhub/api/auth/authresetpost)
- [Swap login credentials for a token](https://swrlab.github.io/ard-eventhub/api/auth/authloginpost)
- [Swap refresh token for new id token](https://swrlab.github.io/ard-eventhub/api/auth/authrefreshpost)

### Events

- [Distribute a next track](https://swrlab.github.io/ard-eventhub/api/events/eventpostv1radiotracknext)
- [Distribute a now-playing track](https://swrlab.github.io/ard-eventhub/api/events/eventpostv1radiotrackplaying)

### Subscriptions

- [Add a new subscription](https://swrlab.github.io/ard-eventhub/api/subscriptions/subscriptionpost)
- [Get details about a single subscription from this user](https://swrlab.github.io/ard-eventhub/api/subscriptions/subscriptionsget)
- [List all subscriptions for this user](https://swrlab.github.io/ard-eventhub/api/subscriptions/subscriptionlist)
- [Remove a single subscription by this user](https://swrlab.github.io/ard-eventhub/api/subscriptions/subscriptionsdelete)

### Topics

- [List all available topics](https://swrlab.github.io/ard-eventhub/api/topics/topicsget)