Skip to main content
Version : 3.5.x

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éraireSignification du sélecteur
inverse3/0Premier Inverse3 index (à partir de 0)
inverse3/A14Inverse3 l'identifiant de l'appareil A14
inverse3/*Tous Inverse3 (symbolique)
*inverse/*Tous les appareils de la gamme Inverse (Inverse3, Inverse3x, Minverse)
verse_grip/0Premier 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 :

  • GET refuse les sélecteurs génériques (ambigus) → 400
  • POST et DELETE accepter 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.

ExpressionSignification
(omission)Toutes les sessions (autorisées sur DELETE (uniquement)
#123 ou 123Session portant le numéro d'identification 123
:0Première session par index
:-1Dernière session par index
profile_namePremière session avec ce profil (peut prêter à confusion)
profile_name:0Première session avec profil + index 0
:default:0Première session avec le profil default à l'index 0

Exemple :

GET /inverse3/0/config/navigation?session=:default:0
Les sessions WebSocket ne nécessitent pas de sélecteurs

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).