get_occupancy_by_room

Funktion

Für Belegungspläne: Gibt alle Belegungen zu einem bestimmten Raum aus. Titel und Veranstaltungsdetails werden verborgen. Dafür umfasst die Rückgabe auch interne Anlässe, Vermietungen und Sperrzeiten, die sonst nicht öffentlich wären. Zusätzlich zu den eigentlichen Einträgen berücksichtigt die Ausgabe auch eine allfällige vorgegebene Pufferzeit, die zwischen Veranstaltungen eingehalten werden muss.

Um alle Belegungen für eine bestimmte Liste abzufragen, verwenden Sie die Funktion get_room_occupancy.

Resource URL

https://api.verowa.ch/get_occupancy_by_room/:instance/:apikey/:room_id/:date_from/:date_to/

Parameter

• Ihr Instanzname :instance
• Ihr API-Key :apikey
• Raum-ID :room_id (0 = alle)
• Datum von :date_from («YYYYMMDD» oder «YYYY-MM-DD»; «0» = egal)
• Datum bis :date_to (wie date_from; «0» = egal)

Beispiele

Details zu allen aktuellen Belegungen:

GET https://api.verowa.ch/get_occupancy_by_room/demo/8209042b1786e26c355d4aea1b8c7b79/0/0/0

Details zu Belegungen im Raum Nr. 14, drei Monate ab dem aktuellen Datum (z.B. 25. Mai 2025):

GET https://api.verowa.ch/get_occupancy_by_room/demo/8209042b1786e26c355d4aea1b8c7b79/14/0/2025-08-25

Die API gibt nur Veranstaltungen aus, die noch nicht ganz vergangen sind. Falls Sie Veranstaltungen archivieren möchten – z.B. um auch frühere Monate anzuzeigen –, müssen Sie die Daten lokal vorhalten.

Server-Antwort (Muster)

{
  "14": [ [i]
Raum-ID; falls nur ein einzelner Raum abgefragt wird, entfällt diese Ebene

    {
      "event_id": 364,
      "datetime_from": "2026-05-16 19:00:00", [i]
Lokale Zeit

      "datetime_to": "2026-05-16 20:00:00",
      "state": "definite" [i]
Status der Veranstaltung: «planned», «definite» oder «canceled»

      "type": "occupied" [i]
Der Eintrag kann sich auf eine Veranstaltung («occupied») oder eine Sperrzeit («blocked») beziehen.

    },
    {
      "event_id": 366,
      "datetime_from": "2026-07-18 19:00:00",
      "datetime_to": "2026-07-18 20:00:00",
      "state": "definite"
      "type": "blocked"
    },
    ...
  ]
}

Zurück