Developers
로그인

채널 API

채널 정보 조회

채널 ID 목록으로 채널의 기본 정보를 조회합니다. 최대 20개까지 한 번에 조회할 수 있습니다.

GET /api/openapi/open/v1/channels

  • 인증: Client ID/Secret

Query 파라미터

파라미터 타입 필수 설명
channelIds string O 채널 ID 목록 (쉼표 구분, 최대 20개). 예: "12345,67890"

응답 (content.data 배열 항목)

필드 타입 설명
channelId string 채널 ID
channelName string 채널 이름
channelHandle string 채널 핸들 (슬러그)
channelImageUrl string | null 채널 이미지 URL
channelDescription string 채널 설명
followerCount number 팔로워 수

팔로워 목록 조회

인증된 사용자 채널의 팔로워 목록을 조회합니다.

GET /api/openapi/open/v1/channels/followers

  • 인증: Access Token (Bearer)
  • 필요 Scope: READ:CHANNEL

Query 파라미터

파라미터 타입 기본값 설명
page number 0 페이지 번호 (0부터 시작)
size number 20 페이지 크기

응답 (content.data 배열 항목)

필드 타입 설명
channelId string 팔로워의 채널 ID
channelName string 팔로워의 채널 이름
channelHandle string 팔로워의 채널 핸들 (슬러그)
createdDate string 팔로우 시작 시간 (ISO 8601)

구독자 목록 조회

인증된 사용자 채널의 구독자 목록을 조회합니다.

GET /api/openapi/open/v1/channels/subscribers

  • 인증: Access Token (Bearer)
  • 필요 Scope: READ:SUBSCRIPTION

Query 파라미터

파라미터 타입 기본값 설명
page number 0 페이지 번호
size number 30 페이지 크기 (1~50)
sort string "RECENT" "RECENT" (최신 순) 또는 "LONGER" (구독 기간 순)

응답 (content.data 배열 항목)

필드 타입 설명
channelId string 구독자의 채널 ID
channelName string 구독자의 채널 이름
channelHandle string 구독자의 채널 핸들 (슬러그)
month number 연속 구독 개월 수
tierNo number 구독 티어 번호
createdDate string 구독 시작 시간 (ISO 8601)

채널 관리자 목록 조회

인증된 사용자 채널의 관리자 목록을 조회합니다.

GET /api/openapi/open/v1/channels/streaming-roles

  • 인증: Access Token (Bearer)
  • 필요 Scope: READ:CHANNEL

응답 (content.data 배열 항목)

필드 타입 설명
managerChannelId string 관리자의 채널 ID
managerChannelName string 관리자의 채널 이름
managerChannelHandle string 관리자의 채널 핸들 (슬러그)
userRole string STREAMING_CHANNEL_OWNER | STREAMING_CHANNEL_MANAGER | STREAMING_CHAT_MANAGER | STREAMING_SETTLEMENT_MANAGER
createdDate string 역할 부여 일시 (ISO 8601)