Auswahlkriterien

Selektoren geben an, auf welches Gerät und welche Sitzung eine HTTP-Anfrage oder ein WebSocket-Befehl abzielt.

Geräteauswahl – URL-Pfad

Wird in allen HTTP-Routen auf Geräteebene verwendet als /{device_type}/{id_or_index}/….

Beispielroute	Bedeutung des Selektors
inverse3/0	Erste Inverse3 Index (0-basiert)
inverse3/A14	Inverse3 Geräte-ID A14
inverse3/*	Alle Inverse3 (Platzhalter)
*inverse/*	Alle Geräte der Inverse-Familie (Inverse3, Inverse3x, Minverse)
verse_grip/0	Erster verkabelter VerseGrip von index
wireless_verse_grip/*	Alle kabellosen VerseGrips
*verse_grip/*	Alle Geräte der VerseGrip-Familie (kabelgebunden, kabellos, kundenspezifisch)

Regeln:

• GET lehnt Platzhalter-Selektoren ab (mehrdeutig) → 400
• POST und DELETE Platzhalter zulassen – Operation wird auf alle Übereinstimmungen angewendet

Unterstützt {device_type} Werte: inverse3, verse_grip, wireless_verse_gripoder Familien-Platzhalter *inverse, *verse_grip.

Sitzungsauswahl — ?session=<expr> Abfrageparameter

HTTP-Endpunkte mit Sitzungsgültigkeit (basis, mount, preset, filters, navigation, SDF) erfordern eine ?session=<expr> Abfrageparameter, um festzulegen, in welchem Sitzungskontext die Operation ausgeführt werden soll.

Ausdruck	Bedeutung
(weggelassen)	Alle Sitzungen (zulässig am DELETE (nur)
#123 oder 123	Sitzung mit der numerischen ID 123
:0	Erste Sitzung nach Index
:-1	Letzte Sitzung nach Index
profile_name	Erste Sitzung mit diesem Profil (kann mehrdeutig sein)
profile_name:0	Erste Sitzung mit Profil + Index 0
:default:0	Erste Sitzung mit Profil default am Index 0

Beispiel:

GET /inverse3/0/config/navigation?session=:default:0

WebSocket-Sitzungen benötigen keine Selektoren

Bei einer WebSocket-Verbindung sind die Sitzung – Ihre configure und commands Einträge beziehen sich automatisch auf die Geräte der aktuellen Sitzung. Sitzungsauswähler werden nur benötigt für HTTP Anfragen (einschließlich sitzungsübergreifender Fernsteuerung – siehe Sitzungen).