createWorkspaceDisplaySession
const url = 'https://dev.api.endueos.com/api/v1/workspaces/wsp_01J9ZK3Q8M4XW7D2N5R6T0V1BC/display/sessions';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"mode":"view"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://dev.api.endueos.com/api/v1/workspaces/wsp_01J9ZK3Q8M4XW7D2N5R6T0V1BC/display/sessions \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "mode": "view" }'Workspace 의 실시간 화면 세션을 연다. 꺼져 있으면 깨운다 (명령과 같은 시작 규칙 — 402 INSUFFICIENT_CREDITS 가 날 수 있다).
managed Linux Workspace 만. 다른 환경은 422 DISPLAY_UNSUPPORTED. 지우는 중이면 409 WORKSPACE_STATE_CONFLICT.
사용자 JWT · Station API 키 · OAuth workspaces:write — 보기 세션도 쓰기 스코프다 (화면 전체를 내보낸다).
파라미터
섹션 제목: “파라미터”경로 파라미터
섹션 제목: “경로 파라미터”예시
wsp_01J9ZK3Q8M4XW7D2N5R6T0V1BC요청 본문필수
섹션 제목: “요청 본문필수”object
기본 view.
201
섹션 제목: “201”비밀값이 든 응답 — 캐시하지 않는다.
object
화면 세션. 클라이언트는 wss://{API host}{socket_path}?ticket={ticket} 에 붙는다 — 응답에 origin 을 싣지 않는다 (이벤트 소켓과 같다).
소켓의 바이너리 프레임이 곧 RFB(3.8) 바이트다. noVNC RFB 에 그 주소를 그대로 준다.
object
화면 세션 — dsp_ + ULID. DB 에 남지 않는다 (relay-service 의 Durable Object 이름, 만든 뒤 60분).
Device 의 id — Resource 와 같은 res_ 다 (v0.1.0 이 이미 냈다).
만들 때 정하고 바뀌지 않는다. 바꾸려면 새 세션을 연다.
소켓 위의 프로토콜 — RFB over WebSocket (바이너리).
/api/v1/display/sessions/{display_session_id}/socket
osdt_ + hex 64. 한 번 쓰면 끝, ticket_expires_at 전에 붙어야 한다 (60초).
세션이 끝나는 시각 — 만든 뒤 60분. 지나면 소켓이 4410 으로 닫힌다. 다시 보려면 새 세션을 연다.
object
서버 처리 시간(ms).
예시
{ "data": { "display_session_id": "dsp_01J9ZK3Q8M4XW7D2N5R6T0V1BC", "device_id": "res_01J9ZK3Q8M4XW7D2N5R6T0V1BC", "workspace_id": "wsp_01J9ZK3Q8M4XW7D2N5R6T0V1BC", "mode": "view", "protocol": "rfb" }}응답 헤더
섹션 제목: “응답 헤더”400
섹션 제목: “400”요청 형식이 틀렸다 — VALIDATION_ERROR(details.errors[]) 또는 BAD_REQUEST. 본문은 오류 봉투.
401
섹션 제목: “401”인증이 없거나 무효다 — UNAUTHORIZED. 본문은 오류 봉투.
402
섹션 제목: “402”크레딧이 없다 — INSUFFICIENT_CREDITS (충전하면 다시 된다). 본문은 오류 봉투.
404
섹션 제목: “404”없거나 내 것이 아니다 — *_NOT_FOUND. 본문은 오류 봉투.
409
섹션 제목: “409”지금 상태와 충돌한다 — 코드는 위 설명을 본다. 본문은 오류 봉투.
422
섹션 제목: “422”형식은 맞지만 할 수 없다 — 코드는 위 설명을 본다. 본문은 오류 봉투.
429
섹션 제목: “429”한도를 넘었다 — Retry-After 초 뒤에 다시. 본문은 오류 봉투.
500
섹션 제목: “500”서버 오류 — INTERNAL_ERROR. 본문은 오류 봉투.
503
섹션 제목: “503”의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.