콘텐츠로 이동

connectDisplaySession

GET
/api/v1/display/sessions/{display_session_id}/socket
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_[0-9A-HJKMNP-TV-Z]{26}$/
예시
dsp_01J9ZK3Q8M4XW7D2N5R6T0V1BC
ticket
필수
string
upgrade
필수
string
허용 값: websocket

WebSocket 으로 바뀐다.

인증이 없거나 무효다 — UNAUTHORIZED. 본문은 오류 봉투.

Upgrade: websocket 이 없다. 본문은 오류 봉투.

한도를 넘었다 — Retry-After 초 뒤에 다시. 본문은 오류 봉투.

의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.