콘텐츠로 이동

connectDisplayAgent

GET
/api/v1/display/sessions/{display_session_id}/agent
curl --request GET \
--url https://dev.api.endueos.com/api/v1/display/sessions/dsp_01J9ZK3Q8M4XW7D2N5R6T0V1BC/agent \
--header 'Sec-WebSocket-Protocol: example' \
--header 'upgrade: websocket'

에이전트 쪽 화면 소켓 — 에이전트 전용 (protocol/platform-tools.md §화면 세션). 사람·앱이 부르는 경로가 아니다. 연결 토큰(osdc_, 1회용)을 Sec-WebSocket-Protocol: endue-os.display.v1, endue-os.token.{토큰} 으로 보낸다. 101 은 endue-os.display.v1 을 고른다. 토큰이 틀리면 401, 이미 에이전트가 붙은 세션이면 409.

  • None
display_session_id
필수

화면 세션 — dsp_ + ULID. DB 에 남지 않는다 (relay-service 의 Durable Object 이름, 만든 뒤 60분).

string
/^dsp_[0-9A-HJKMNP-TV-Z]{26}$/
예시
dsp_01J9ZK3Q8M4XW7D2N5R6T0V1BC
Sec-WebSocket-Protocol
필수
string

endue-os.display.v1, endue-os.token.{연결 토큰}

upgrade
필수
string
허용 값: websocket

WebSocket 으로 바뀐다.

Sec-WebSocket-Protocol
필수
string
허용 값: endue-os.display.v1

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

지금 상태와 충돌한다 — 코드는 위 설명을 본다. 본문은 오류 봉투.

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

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

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