get_room_occupancy

Funktion

Für Belegungspläne: Gibt alle Raumbelegungen aus, evtl. auf eine bestimmte Liste beschränkt. Titel und Veranstaltungsdetails werden verborgen. Dafür umfasst die Rückgabe je nach Listendefinition 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 einen bestimmten Raum abzufragen, verwenden Sie besser die Funktion get_occupancy_by_room.

Resource URL

https://api.verowa.ch/get_room_occupancy/:instance/:apikey/:list_id/:date_from/:date_to/

Parameter

• Ihr Instanzname :instance
• Ihr API-Key :apikey
• Listen-ID :list_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_room_occupancy/demo/8209042b1786e26c355d4aea1b8c7b79/0/0/0

Details zu Belegungen von Anlässen der Liste 619, drei Monate ab dem aktuellen Datum (z.B. 14. Mai 2025):

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

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

    {
      "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