방송 참여 API

구현 상태: 예정

시청자 입장 시 세션 생성과 채팅 인증 정보를 반환합니다.

Endpoint

POST /broadcasts/{broadcastId}/join

Header

Content-Type: application/json
X-API-Key: {API_KEY}

Path Parameter

  • broadcastId (string, 필수)

Request Body

{
  "userId": "user-1001",
  "nickname": "viewer",
  "bulletCode": "7"
}
필드 타입 필수 설명
userId string 필수 시청자 식별자
nickname string 필수 채팅 표시 이름
bulletCode string 선택 채팅 아이콘/불렛 코드

Response (성공)

{
  "broadcastId": "string",
  "status": "LIVE",
  "sessionId": "string",
  "sessionExpiresAt": "2026-03-17T10:45:00Z",
  "playbackUrl": "https://example-playback.m3u8",
  "chat": {
    "endpoint": "wss://example-chat",
    "token": "string",
    "expiresAt": "2026-03-17T10:45:00Z"
  }
}

오류 코드

  • UNAUTHORIZED_API_KEY (401)
  • BROADCAST_NOT_FOUND (404)
  • BROADCAST_NOT_JOINABLE (409)
  • BROADCAST_FULL (409)
  • INVALID_REQUEST (400)