选择器

设备选择器 — URL 路径

用于所有设备级 HTTP 路由中，作为 /{device_type}/{id_or_index}/….

类过滤器在索引之前就已解析完毕

该规则同样适用于通配符选择器： *inverse/* 和 *verse_grip/* 匹配 每个 该系列中的设备，以及 POST / DELETE 针对以下目标的请求： 这些选择器将操作应用于 每个 匹配——不仅仅是第一个 。

支持 {device_type} 值： inverse3, verse_grip, wireless_verse_grip， 或家族通配符 *inverse, *verse_grip.

会话选择器 — ?session=<expr> 查询参数

会话作用域的 HTTP 端点（basis、mount、preset、filters、navigation、SDF） 需要一个 ?session=<expr> 查询参数，用于确定在哪个会话上下文中进行操作。表达

示例：

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

配置文件名称通配符

配置文件模式支持两种通配符：

其他所有角色——包括 :, ., -, [, ] — 进行字面匹配（字符类，例如 [abc] 是 不 （受支持）。匹配操作区分大小写。

一个光秃秃的 * （或 all) 保留其原有的含义，即 所有会议. 匹配名称以 开头的个人资料 *，请包含至少一个其他字符（例如 *foo).

通配符模式是 模棱两可 单独使用（它可以匹配多个会话）。要在...上使用它： a GET / POST 端点，通过尾部内容消除歧义 :<index>:

                
# First session in the Haply Hub namespace
GET /inverse3/0/config/basis?session=co.haply.hub::*:0

# Last session in a Unity namespace
GET /inverse3/0/config/mount?session=:co.haply.unity::*:-1
        
              

含糊通配符（无索引）将被拒绝，具体表现为 400 在 GET/POST 请求中。在明确支持多会话匹配的路由上，这些请求会被允许—— GET /sessions/<sel> （返回所有匹配项）以及 DELETE 端点（应用于每次匹配）。

会话选择器 — URL 路径

"(《世界人权宣言》) /sessions/{selector} 端点接受 与路径相同的表达式 参数 — 适用于查询单个会话或验证其是否存在：

                
GET /sessions                      # list all active sessions
GET /sessions/:default:0           # one session by profile + index
GET /sessions/:-1                  # last active session
GET /sessions/#42                  # session id 42
GET /sessions/co.haply.hub::*      # every session in the co.haply.hub:: namespace
GET /sessions/co.haply.hub::*:0    # first session in that namespace
        
              

这在功能上等同于 GET /sessions?session=<selector>; 这两条路由都调用了同一个处理程序。 GET /sessions/<sel> 是少数几个端点之一， 它允许使用没有 的模糊通配符模式 :<index> 后缀 — it 将所有匹配项返回至与 GET /sessions.