선택기
선택기는 HTTP 요청이나 WebSocket 명령이 어떤 장치와 어떤 세션을 대상으로 하는지 식별합니다.
장치 선택기 — URL 경로
모든 장치 수준 HTTP 경로에서 다음과 같이 사용됩니다. /{device_type}/{id_or_index}/….
| 경로 예시 | 선택기의 의미 |
|---|---|
inverse3/0 | 인덱스(0부터 시작) Inverse3 첫 번째 Inverse3 |
inverse3/A14 | 장치 ID가 Inverse3 A14 |
inverse3/* | 모든 Inverse3 (일괄 지정) |
*inverse/* | 모든 Inverse 시리즈 기기(Inverse3, Inverse3x, Minverse) |
verse_grip/0 | 인덱스사의 첫 유선 VerseGrip |
wireless_verse_grip/* | 모든 무선 VerseGrips |
*verse_grip/* | 모든 VerseGrip 제품군 기기(유선, 무선, 맞춤형) |
규칙:
GET와일드카드 선택자(모호함)를 허용하지 않음 →400POST그리고DELETE와일드카드 허용 — 일치하는 모든 항목에 적용되는 작업
지원됨 {device_type} 값: inverse3, verse_grip, wireless_verse_grip,
또는 가족 와일드카드 *inverse, *verse_grip.
세션 선택기 — ?session=<expr> 쿼리 매개변수
세션 범위 내 HTTP 엔드포인트(basis, mount, preset, filters, navigation, SDF)는
다음이 필요합니다. ?session=<expr> 어떤 세션의 컨텍스트에서
작업을 수행할지 식별하기 위한 쿼리 매개변수.
| 표현 | 뜻 |
|---|---|
| (생략) | 모든 세션 (허용되는 DELETE (단) |
#123 또는 123 | ID가 123인 세션 |
:0 | 인덱스별 첫 번째 세션 |
:-1 | 인덱스별 최근 세션 |
profile_name | 이 프로필을 사용한 첫 번째 세션입니다 (의미가 모호할 수 있음) |
profile_name:0 | 프로필 및 인덱스 0을 포함한 첫 번째 세션 |
:default:0 | 프로필을 사용한 첫 번째 세션 default 인덱스 0에서 |
예시:
GET /inverse3/0/config/navigation?session=:default:0
WebSocket 세션에는 선택자가 필요하지 않습니다
웹소켓 연결에서, 당신은 는 세션 — 귀하의 configure 그리고
commands 항목은 자동으로 현재 세션의 기기를 대상으로 합니다. 세션
선택자는 다음의 경우에만 필요합니다. HTTP 요청(세션 간
원격 제어 포함 — 참조: 세션).