Channel
채널 API로 채널 정보 조회, 채널 관리자 조회, 채널 팔로워 조회, 채널 구독자를 조회할 수 있습니다.
채널 API 중 아래 API Scope를 호출하려면 사용자 계정으로 인증하여 얻은 Access Token이 필요합니다.
API Scope는 채널 관리자 조회, 채널 팔로워 조회, 채널 구독자 조회입니다.
채널 정보 조회
채널 정보를 조회할 수 있습니다. 채널 정보 조회 API를 호출하려면 애플리케이션 등록 후 Client 인증이 필요합니다. (Client 인증 API 참조)
GET /open/v1/channels
채널 정보 조회
Request Param
channelIds
String[]
*
조회할 채널 ID 목록. 최대 20개까지 요청 가능
Response Body
data
Object[]
요청한 채널 정보 목록. 일치하는 채널을 찾지 못할 경우 결과 미반환
channelId
String
채널 식별자
channelName
String
채널 이름
channelImageUrl
String
채널 이미지 URL
followerCount
Int
채널의 팔로워 수
verifiedMark
Boolean
채널 인증 마크 여부
채널 관리자 조회
채널 관리자를 조회할 수 있습니다.
GET /open/v1/channels/streaming-roles
채널 관리자 조회
Response Body
data
Object[]
요청한 채널 관리자 목록
managerChannelId
String
관리자 채널 식별자
managerChannelName
String
관리자 채널 이름
userRole
String
관리자 역할
STREAMING_CHANNEL_OWNER - 채널 소유자
STREAMING_CHANNEL_MANAGER - 채널 관리자
STREAMING_CHAT_MANAGER - 채팅 운영자
STREAMING_SETTLEMENT_MANAGER - 정산 관리자
createdDate
Date
등록일
채널 팔로워 조회
채널의 팔로워 목록을 조회할 수 있습니다.
GET /open/v1/channels/followers
채널 팔로워 조회
Request Param
page
Int
optional
요청하는 페이지. 0부터 시작
디폴트 값 : 0
size
Int
optional
조회할 카테고리 개수. 최소 1 ~ 최대 50 요청 가능 디폴트 값 : 30
Response Body
data
Object[]
요청한 채널의 팔로워 목록
channelId
String
팔로워 채널 식별자
channelName
String
팔로워 채널 이름
createdDate
Date
팔로우 일자
채널 구독자 조회
채널의 구독자 목록을 조회할 수 있습니다.
GET /open/v1/channels/subscribers
채널 구독자 조회
Request Param
page
Int
optional
요청하는 페이지. 0부터 시작
디폴트 값 : 0
size
Int
optional
조회할 카테고리 개수. 최소 1 ~ 최대 50 요청 가능 디폴트 값 : 30
sort
String
optional
정렬 방식
RECENT (최신 구독 순)
LONGER (구독 개월 순)
Response Body
data
Object[]
요청한 채널의 구독자 목록
channelId
String
구독자 채널 식별자
channelName
String
구독자 채널 이름
month
Int
구독 개월 수
tierNo
Int
구독 상품
1 (티어1 구독)
2 (티어2 구독)
createdDate
Date
팔로우 일자
Last updated