Kapitel 12

API & iCalendar

API-Schlüssel verwalten, Kalender-Feeds abonnieren

iCalendar-Feeds: Termine im eigenen Kalender

Unter Hilfreiches → iCalendar-Feed stellt Venue Timer Kalender-URLs bereit, die du in jeder Kalender-App (Apple/Google Kalender, Outlook, …) abonnieren kannst. Die Seite enthält bebilderte Anleitungen für iPhone, Android und Outlook:

In der Manager-Ansicht gibt es zwei Feeds:

• Öffentliche Termine – die Spieltermine deiner Firma, geeignet zum Teilen (z. B. mit Partnern).
• Interne Termine – die vollständige interne Terminliste.

Mitarbeiter mit Personal-Rolle finden an derselben Stelle zusätzlich den Feed für ihren persönlichen Dienstplan (siehe Kapitel 10).

Die API: Venue Timer mit anderen Systemen verbinden

Über die API können andere Systeme lesend und schreibend auf eure Daten zugreifen – zum Beispiel eure Website, die automatisch den Spielplan anzeigt, oder ein Kassensystem, das Ticketstände zurückmeldet.

API-Schlüssel verwalten

Unter API → API-Schlüssel verwalten Firmen-Administratoren die Zugänge:

Beim Anlegen eines Schlüssels vergibst du einen sprechenden Namen (z. B. „Website-Kalender (nur lesen)“) und wählst pro Datenart die Rechte Lesen, Schreiben und Löschen – etwa Programme, Spieltermine, Räume, Raumkonfigurationen, Kontakte, Personal oder Rechnungen (Rechnungen sind grundsätzlich nur lesbar). So bekommt jedes angebundene System genau die Rechte, die es braucht – und nicht mehr.

API-Dokumentation

Nachdem ein API-Schlüssel angelegt wurde, kannst du die API v2 nutzen. Sende dazu den Header:

Authorization: ApiKey <Schlüssel>

Die vollständige technische Dokumentation ist frei zugänglich:

• API-Referenz (Swagger UI) ↗ – alle Endpunkte mit Parametern und Beispielen, direkt ausprobierbar.
• OpenAPI-Schema als JSON herunterladen – zum Erzeugen von Client-Code.

Veraltete API-Schlüssel (v1)

Falls eure Firma noch Schlüssel der ersten API-Generation nutzt, werden sie auf der API-Schlüssel-Seite separat als „Veraltete API-Schlüssel (v1)“ angezeigt. Neue Anbindungen solltest du ausschließlich mit den aktuellen Schlüsseln bauen.