ch_all_info
ch_all_info
스트리밍 서버에 할당 된 모든 채널 정보를 요청합니다.
API Response
200 OK
{"result_code":0,"result_msg":"SUCCESS", "channel":[{...}] ...}200 OK
{"result_code":20000,"result_msg":"JSON data is Null"}Body
result code 와 result message, channel 별 부가설명은 다음과 같습니다.
result_code
0
성공
10000~19999
API Server Error
20000~20399
API Data Error
20400~20499
API DB Error
31000~31999
채널 조건 Error
32000~32999
스케줄 조건 Error
API 요청 후 result_code 값이 0이 아닌 경우, API 처리에 실패했다는 뜻입니다. 해당하는 경우 CDN 담당자에게 result_code , result_message 내용을 참조하여 문의바랍니다.
0
SUCCESS
API 처리 성공
25000
auth_fail
서버 인증 실패
30001
user_permisision_denied
채널의 상태가 On-Air가 아니기 때문에 API 처리 실패
result_message 는 API 서버에서 성공, 실패한 원인에 대한 내용을 기술합니다. ch_all_info API 사용시 발생할 수 있는 가장 많은 메세지들에 대한 설명을 기술합니다.
id
채널의 고유 식별자
status
채널 상태 여부
0 : Idle , Off-Air 서비스 중이 아님
1 : On-Air 서비스 중, Active 상태 (스케줄 채널 대상)
6 : Force 서비스문제가있어, 자동백업 서비스를위해 강제 503 응답처리 상태
7 : Ready 서비스 중, Active 상태 (파일 채널 대상)
ch_name
채널 이름
programs 의 경우 id와 동일
스케줄 채널의 경우 CDN 담당자가 설정해 둔 이름 출력
더 다양한 status 값이 있지만, 사용자 입장에서 이 외에 status 값이 조회 될 경우는 거의 드뭅니다. 문제 발생시, 이 외 status 값에 대한 발생 시 CDN 담당자에게 문의합니다.
output
채널의 output 설정
segment_opt
hls segment 설정
play_list_chunk_count
duration_time
segment_opt/playlist_chunk_count
playlist의 segment 개수
palylist에 노출될 segment의 개수
segment_opt/duration_time
segment의 시간
segment 를 나눌 기준이 될 시간 값 (초 단위)
ch_all_info 조회 시, output 설정이 노출되는 채널은 output이 존재하는 채널입니다.
보통 서비스 구성 시, 파일 채널은 개별 재생을 지원하지 않기 때문에 파일 채널은 해당 내용이 노출되지 않습니다.
edge
채널 재생 설정
streams/protocol_type
재생 stream 타입
hls
mpeg-dash
streams/stream
재생 stream 주소
ch_all_info 조회 시, edge 설정이 노출되는 채널은 output이 존재하는 채널입니다.
보통 서비스 구성 시, 파일 채널은 개별 재생을 지원하지 않기 때문에 파일 채널은 해당 내용이 노출되지 않습니다.
Manager에 등록된 모든 채널에 대한 목록을 조회합니다.
Successful operation
정의되지 않은 API 호출, Undefined API Call
존재하지 않는 App 혹은 Stream, Undefined App or Stream
허용하지 않는 Method 요청, Deny for Method
서버 에러, Server Error
GET /ch_all_info HTTP/1.1
Host: solrtmp.solbox.com:8080
Accept: */*
{
"result_code": 0,
"result_msg": "success",
"channel": [
{
"id": "abcd",
"status": 0,
"ch_name": "test",
"use_alarm": 0,
"use_notify": 0,
"regist_date": "1713990725000",
"regist_date_str": "2024-04-25 05:32:05",
"update_date": "1713990725000",
"update_date_str": "2024-04-25 05:32:05"
}
]
}Last updated