connectDisplaySession
GET
/api/v1/display/sessions/{display_session_id}/socket
const url = 'https://dev.api.endueos.com/api/v1/display/sessions/dsp_01J9ZK3Q8M4XW7D2N5R6T0V1BC/socket?ticket=example';const options = {method: 'GET', headers: {upgrade: 'websocket'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://dev.api.endueos.com/api/v1/display/sessions/dsp_01J9ZK3Q8M4XW7D2N5R6T0V1BC/socket?ticket=example' \ --header 'upgrade: websocket'화면 소켓 (RFB over WebSocket). 입장권으로만 인증한다 — 브라우저는 Authorization 헤더를 싣지 못한다.
붙으면 서버가 기기의 에이전트를 불러 VNC 서버와 잇는다. 그동안(최대 60초) 아무것도 오지 않는다 — 그다음 RFB 인사(RFB 003.008\n)부터 그대로.
입장권이 틀려도 받은 뒤 닫는다 — 브라우저는 업그레이드 거절의 상태 코드를 읽지 못해서다 (형식이 틀린 id · 입장권이 없는 요청만 401). 닫힘 코드:
4401 입장권 무효(없음·틀림·씀·만료) · 4408 기기가 60초 안에 붙지 않음 · 4422 기기에 디스플레이가 없음 · 4429 기기의 화면 세션이 꽉 참(4개) ·
4410 세션 시간(60분) 끝 · 1011 기기 쪽이 끊김 · 1000 정상 종료.
- None
파라미터
섹션 제목: “파라미터”경로 파라미터
섹션 제목: “경로 파라미터”display_session_id
필수
화면 세션 — dsp_ + ULID. DB 에 남지 않는다 (relay-service 의 Durable Object 이름, 만든 뒤 60분).
string
예시
dsp_01J9ZK3Q8M4XW7D2N5R6T0V1BC쿼리 파라미터
섹션 제목: “쿼리 파라미터”ticket
필수
string
헤더 파라미터
섹션 제목: “헤더 파라미터”upgrade
필수
string
101
섹션 제목: “101”WebSocket 으로 바뀐다.
401
섹션 제목: “401”인증이 없거나 무효다 — UNAUTHORIZED. 본문은 오류 봉투.
426
섹션 제목: “426”Upgrade: websocket 이 없다. 본문은 오류 봉투.
429
섹션 제목: “429”한도를 넘었다 — Retry-After 초 뒤에 다시. 본문은 오류 봉투.
503
섹션 제목: “503”의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.