Sélecteurs
Les sélecteurs permettent d'identifier le périphérique et la session auxquels une requête HTTP ou une commande WebSocket est destinée.
Sélecteur d'appareil — Chemin d'accès URL
Utilisé dans toutes les routes HTTP au niveau de l'appareil comme /{device_type}/{id_or_index}/….
| Exemple d'itinéraire | Signification du sélecteur |
|---|---|
inverse3/0 | Premier Inverse3 index (à partir de 0) |
inverse3/A14 | Inverse3 l'identifiant de l'appareil A14 |
inverse3/* | Tous Inverse3 (symbolique) |
*inverse/* | Tous les appareils de la gamme Inverse (Inverse3, Inverse3x, Minverse) |
verse_grip/0 | Premier VerseGrip câblé par index |
wireless_verse_grip/* | Tous les VerseGrips sans fil |
*verse_grip/* | Tous les appareils de la gamme VerseGrip (avec fil, sans fil, sur mesure) |
Règles :
GETrefuse les sélecteurs génériques (ambigus) →400POSTetDELETEaccepter les caractères génériques — opération appliquée à toutes les correspondances
Prise en charge {device_type} valeurs : inverse3, verse_grip, wireless_verse_grip,
ou des caractères génériques de famille *inverse, *verse_grip.
Sélecteur de session — ?session=<expr> paramètre de requête
Les points de terminaison HTTP liés à la session (basis, mount, preset, filters, navigation, SDF)
nécessitent un ?session=<expr> paramètre de requête permettant de déterminer le contexte de session
dans lequel opérer.
| Expression | Signification |
|---|---|
| (omission) | Toutes les sessions (autorisées sur DELETE (uniquement) |
#123 ou 123 | Session portant le numéro d'identification 123 |
:0 | Première session par index |
:-1 | Dernière session par index |
profile_name | Première session avec ce profil (peut prêter à confusion) |
profile_name:0 | Première session avec profil + index 0 |
:default:0 | Première session avec le profil default à l'index 0 |
Exemple :
GET /inverse3/0/config/navigation?session=:default:0
Sur une connexion WebSocket, vous sont la session — votre configure et
commands Les entrées ciblent automatiquement les périphériques de la session en cours. Les
sélecteurs de session ne sont nécessaires que pour HTTP demandes (y compris la commande à distance
entre sessions — voir Séances).