채널 목록 조회

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

Live Station은 채널의 목록을 조회하기 위한 API를 제공합니다.

요청

GET https://livestation.apigw.ntruss.com/api/v2/channels?pageNo={pageNo}&pageSizeNo={pageSizeNo}&channelStatus={channelStatus}&id={channelId}&channelName={channelName}

요청 파라미터

파라미터명	필수 여부	타입	제약 사항	설명
pageNo	No	Integer	제약 없음	조회 할 페이지 인덱스
pageSizeNo	No	Integer	1~100	목록 조회시 포함될 채널 수 예시) 생성된 채널이 60개일때, pageSizeNo 30 이라면 페이지당 30개씩 채널 목록 조회
channelStatus	No	String	READY, PUBLISHING, BLOCK	조회 할 채널 상태
id	No	String	제약 없음	조회 할 채널 ID
channelName	No	String	제약 없음	조회 할 채널명

요청 헤더

헤더명	필수 여부	설명
x-ncp-apigw-timestamp	YES	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	YES	네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값 `x-ncp-iam-access-key:{Sub Account Access Key}`
x-ncp-apigw-signature-v2	YES	Access Key ID 값과 Secret Key로 암호화한 서명 `x-ncp-apigw-signature-v2:{API Gateway Signature}`
x-ncp-region_code	YES	리전 코드 (KR)

응답

필드명	타입	설명	비고
channelId	String
channelName	String
instanceNo	String
qualitySetId	Integer
qualitySetName	String
outputProtocol	String
channelStatus	String	CREATING, READY, PUBLISH, DELETED, BLOCK, FORCE_BLOCK, FORCE_DELETED
isRecording	Boolean
useDvr	Boolean
immediateOnAir	Boolean	true, false
timemachineMin	Integer		단위: Minute
cdn	Object
cdn.cdnType	String	GLOBAL_CDN, GLOBAL_EDGE
cdn.instanceNo	String		NO_CDN 이면 0
cdn.profileId	Integer	Global Edge 의 프로필 ID	NO_CDN 이면 0
cdn.statusName	String	CDN 상태	RUNNING, PUBLISHING, STOPPING, STOPPED, CREATING, CHANGING, CDN_NOT_FOUND
cdn.serviceName	String	CDN Service Name	NO_CDN 이면 ""
cdn.cdnDomain	String	CDN Domain	NO_CDN 이면 ""
snapshot	Object
snapshotId	Integer
record	Object
record.format	String	MP4,HLS,ALL
record.type	String	NO_RECORD, AUTO_UPLOAD, MANUAL_UPLOAD
record.bucketName	String
record.filePath	String
record.accessControl	String	PRIVATE, PUBLIC_READ
uploadPath	String	AUTO_UPLOAD 옵션일때 녹화 파일 업로드 경로
publishUrl	String
globalPublishUrl	String	해외 송출 지원을 위한 URL
streamKey	String
recentPublishStartTime	Integer
createdTime	Integer
alertOn	Boolean
alertOptions	Object
alertOptions.alertChangeStatus	Boolean
alertOptions.alertVodUploadFail	Boolean
alertOptions.alertReStreamFail	Boolean
totalPublishSeconds	Integer
envType	String	DEV, STAGE, REAL
callbackEndpoint	String
backupStreamKey	String	송출 이중화를 위한 백업 스트림키
isStreamFailOver	Boolean	송출 이중화 설정 적용 여부	true, false
origin	Object	CDN 연동을 위한 Live station 원본 정보
origin.originDomain	String	CDN 연동을 위한 Live station 원본 도메인
origin.originPath	String	CDN 연동을 위한 Live station 원본 상세 경로
drmEnabledYn	Boolean	DRM Encryption 설정 적용 유무
drm	Object	Live Station 을 활용한 DRM Encryption 설정
drm.siteId	String	One Click Multi DRM 상품을 통해 생성한 site id
drm.contentId	String	DRM Encryption 을 적용할 콘텐츠의 고유 ID DRM 패키징을 위해 사용되며 최소 3글자 이상 영문/숫자 또는 ‘-'(하이픈), ‘_'(언더바) 포함 최대 100자 문자까지 입력 가능합니다.

예시

요청 예시

GET /api/v2/channels?pageNo=1&pageSizeNo=10
HOST: livestation.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp:1621242480854
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
x-ncp-region_code:KR

응답 예시

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 26 Sep 2021 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
  "content": [
    {
      "channelId": "ls-20210406135408-FNGOA",
      "channelName": "mychannel1",
      "instanceNo": 1675706,
      "qualitySetId": 1,
      "qualitySetName": "passthrough",
      "outputProtocol": "HLS, DASH",
      "channelStatus": "PUBLISHING",
      "isRecording": false,
      "useDVR": true,
      "immediateOnAir": false,
      "timemachineMin": 360,
      "cdn": {
        "instanceNo": "1163900",
        "serviceName": "edge-ls-20230914204831-1BRHO",
        "statusName": "RUNNING",
        "cdnType": "GLOBAL_EDGE",
        "cdnDomain": "mycdn.edge.naverncp.com",
        "profileId": 299,
        "regionType": "KOREA"
      },
      "record": {
        "type": "AUTO_UPLOAD",
        "bucketName": "hls",
        "filePath": "/livestation",
        "format": "MP4",
        "accessControl": "PRIVATE"
      },
      "drm": {
        "contentId": "my-first-drm",
        "siteId": "drm-20231120182420-dPTGn"
      },
      "drmEnabledYn": true,
      "uploadPath": "/hls/livestation",
      "streamKey": "smnagylbpycrhxvjuzfx6b83v5zbg0w1",
      "publishUrl": "rtmp://live-station-rtmp-url",
      "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
      "totalPublishSeconds": 34193,
      "createdTime": 1617684849000,
      "alertOn": false,
      "recentPublishStartTime": 1621238492000,
      "alertOptions": {
        "alertChangeStatus": false,
        "alertVodUploadFail": false,
        "alertReStreamFail": false
      },
      "callbackEndpoint": "https://my-callback-endpoint",
      "envType": "STAGE"
    },
    {
      "channelId": "ls-20210302103926-4QyAE",
      "channelName": "mychannel2",
      "instanceNo": 1632544,
      "qualitySetId": 6,
      "qualitySetName": "360p-set",
      "outputProtocol": "HLS, DASH",
      "channelStatus": "READY",
      "isRecording": true,
      "useDVR": true,
      "immediateOnAir": true,
      "timemachineMin": 360,
      "cdn": {
        "instanceNo": "1527496",
        "serviceName": "cdn-ls-20201112153428-E5ZLH",
        "statusName": "running",
        "cdnType": "GLOBAL_EDGE",
        "cdnDomain": "mycdn.edge.naverncp.com",
        "profileId": 299,
        "regionType": "KOREA"
      },
      "record": {
        "type": "MANUAL_UPLOAD",
        "accessControl": "PRIVATE"
      },
      "streamKey": "83j2v3v32gsc2c1bez7e3ae7t0uckix2",
      "publishUrl": "rtmp://live-station-rtmp-url",
      "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
      "totalPublishSeconds": 3559,
      "createdTime": 1614649167000,
      "alertOn": false,
      "recentPublishStartTime": 1617612443000,
      "alertOptions": {
        "alertChangeStatus": false,
        "alertVodUploadFail": false,
        "alertReStreamFail": false
      },
      "callbackEndpoint": "https://my-callback-endpoint",
      "envType": "STAGE"
    },
    {
      "channelId": "ls-20210226182505-7mkQg",
      "channelName": "mychannel3",
      "instanceNo": 1629316,
      "qualitySetId": 6,
      "qualitySetName": "360p-set",
      "outputProtocol": "HLS, DASH",
      "channelStatus": "READY",
      "isRecording": true,
      "useDVR": true,
      "immediateOnAir": true,
      "timemachineMin": 360,
      "cdn": {
        "instanceNo": "1527496",
        "serviceName": "cdn-ls-20201112153428-E5ZLH",
        "statusName": "running",
        "cdnType": "GLOBAL_EDGE",
        "cdnDomain": "mycdn.edge.naverncp.com",
        "profileId": 299,
        "regionType": "KOREA"
      },
      "record": {
        "type": "AUTO_UPLOAD",
        "bucketName": "hls",
        "filePath": "/livestation",
        "format": "MP4",
        "accessControl": "PRIVATE"
      },
      "uploadPath": "/hls/livestation",
      "streamKey": "ui1b9ysclvel3r1osasulab37d6584zo",
      "publishUrl": "rtmp://live-station-rtmp-url",
      "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
      "totalPublishSeconds": 0,
      "createdTime": 1614331505000,
      "alertOn": false,
      "alertOptions": {
        "alertChangeStatus": false,
        "alertVodUploadFail": false,
        "alertReStreamFail": false
      },
      "callbackEndpoint": "https://my-callback-endpoint",
      "envType": "REAL"
    },
    {
      "channelId": "ls-20210225184529-ab0p0",
      "channelName": "mychannel4",
      "instanceNo": 1627067,
      "qualitySetId": 6,
      "qualitySetName": "360p-set",
      "outputProtocol": "HLS, DASH",
      "channelStatus": "READY",
      "isRecording": false,
      "useDVR": true,
      "immediateOnAir": true,
      "timemachineMin": 360,
      "cdn": {
        "instanceNo": "1527496",
        "serviceName": "cdn-ls-20201112153428-E5ZLH",
        "statusName": "running",
        "cdnType": "GLOBAL_EDGE",
        "cdnDomain": "mycdn.edge.naverncp.com",
        "profileId": 299,
        "regionType": "KOREA"
      },
      "record": {
        "type": "AUTO_UPLOAD",
        "bucketName": "mp4",
        "filePath": "/livestation/mp4",
        "format": "MP4",
        "accessControl": "PRIVATE"
      },
      "uploadPath": "/mp4/livestation/mp4",
      "streamKey": "x1ikvfjje2sfalltav9c8aa90g6bdwt7",
      "publishUrl": "rtmp://live-station-rtmp-url",
      "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
      "totalPublishSeconds": 15217,
      "createdTime": 1614246330000,
      "alertOn": false,
      "recentPublishStartTime": 1617844568000,
      "alertOptions": {
        "alertChangeStatus": false,
        "alertVodUploadFail": false,
        "alertReStreamFail": false
      },
      "callbackEndpoint": "https://my-callback-endpoint",
      "envType": "REAL"
    },
    {
      "channelId": "ls-20210224095620-Jx775",
      "channelName": "mychannel5",
      "instanceNo": 1623674,
      "qualitySetId": 2,
      "qualitySetName": "audio-only",
      "outputProtocol": "HLS, DASH",
      "channelStatus": "READY",
      "isRecording": true,
      "useDVR": true,
      "immediateOnAir": true,
      "timemachineMin": 360,
      "cdn": {
        "instanceNo": "1536104",
        "serviceName": "vscdn-DmcAKhX",
        "statusName": "running",
        "cdnType": "GLOBAL_EDGE",
        "cdnDomain": "mycdn.edge.naverncp.com",
        "profileId": 299,
        "regionType": "KOREA"
      },
      "record": {
        "type": "MANUAL_UPLOAD",
        "accessControl": "PRIVATE"
      },
      "streamKey": "ywgtjsp153zy4d1vzod84a934r54cdk7",
      "publishUrl": "rtmp://live-station-rtmp-url",
      "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
      "totalPublishSeconds": 0,
      "createdTime": 1614128181000,
      "alertOn": false,
      "alertOptions": {
        "alertChangeStatus": false,
        "alertVodUploadFail": false,
        "alertReStreamFail": false
      },
      "callbackEndpoint": "https://my-callback-endpoint",
      "envType": "REAL"
    },
    {
      "channelId": "ls-20210202105451-xVxAe",
      "channelName": "mychannel6",
      "instanceNo": 1593170,
      "qualitySetId": 4,
      "qualitySetName": "720p-set",
      "outputProtocol": "HLS, DASH",
      "channelStatus": "READY",
      "isRecording": false,
      "useDVR": true,
      "immediateOnAir": true,
      "timemachineMin": 360,
      "cdn": {
        "instanceNo": "1217836",
        "serviceName": "cdn-ls-20200604210934-JUlYB",
        "statusName": "running",
        "cdnType": "GLOBAL_EDGE",
        "cdnDomain": "mycdn.edge.naverncp.com",
        "profileId": 299,
        "regionType": "KOREA"
      },
      "record": {
        "type": "MANUAL_UPLOAD",
        "accessControl": "PRIVATE"
      },
      "streamKey": "fwocwhvo00xtuo1h6okvl9qelkh9c32d",
      "publishUrl": "rtmp://live-station-rtmp-url",
      "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
      "totalPublishSeconds": 1615,
      "createdTime": 1612230891000,
      "alertOn": false,
      "recentPublishStartTime": 1613442172000,
      "alertOptions": {
        "alertChangeStatus": false,
        "alertVodUploadFail": false,
        "alertReStreamFail": false
      },
      "callbackEndpoint": "https://my-callback-endpoint",
      "envType": "REAL"
    },
    {
      "channelId": "ls-20210114185131-kmrbH",
      "channelName": "mychannel7",
      "instanceNo": 1574189,
      "qualitySetId": 6,
      "qualitySetName": "360p-set",
      "outputProtocol": "HLS, DASH",
      "channelStatus": "READY",
      "isRecording": false,
      "useDVR": false,
      "immediateOnAir": false,
      "timemachineMin": 0,
      "cdn": {
        "instanceNo": "1158537",
        "serviceName": "lsv2-cdn-lsv2-20200317170245-23p42",
        "statusName": "running",
        "cdnType": "GLOBAL_EDGE",
        "cdnDomain": "mycdn.edge.naverncp.com",
        "profileId": 299,
        "regionType": "KOREA"
      },
      "record": {
        "type": "MANUAL_UPLOAD",
        "accessControl": "PRIVATE"
      },
      "streamKey": "wwbsun5iwjvm2u12v732f9aiu6jnu4xb",
      "publishUrl": "rtmp://live-station-rtmp-url",
      "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
      "totalPublishSeconds": 512,
      "createdTime": 1610617891000,
      "alertOn": false,
      "recentPublishStartTime": 1610619881000,
      "alertOptions": {
        "alertChangeStatus": false,
        "alertVodUploadFail": false,
        "alertReStreamFail": false
      },
      "callbackEndpoint": "https://my-callback-endpoint",
      "envType": "REAL"
    },
    {
      "channelId": "ls-20210114184055-uasYt",
      "channelName": "mychannel8",
      "instanceNo": 1574169,
      "qualitySetId": 6,
      "qualitySetName": "360p-set",
      "outputProtocol": "HLS, DASH",
      "channelStatus": "READY",
      "isRecording": false,
      "useDVR": false,
      "immediateOnAir": false,
      "timemachineMin": 0,
      "cdn": {
        "instanceNo": "1217836",
        "serviceName": "cdn-ls-20200604210934-JUlYB",
        "statusName": "running",
        "cdnType": "GLOBAL_EDGE",
        "cdnDomain": "mycdn.edge.naverncp.com",
        "profileId": 299,
        "regionType": "KOREA"
      },
      "record": {
        "type": "MANUAL_UPLOAD",
        "accessControl": "PRIVATE"
      },
      "streamKey": "kvkqgxh613syvu1d8q5399aim2gsuql5",
      "publishUrl": "rtmp://live-station-rtmp-url",
      "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
      "totalPublishSeconds": 813,
      "createdTime": 1610617256000,
      "alertOn": false,
      "recentPublishStartTime": 1611279629000,
      "alertOptions": {
        "alertChangeStatus": false,
        "alertVodUploadFail": false,
        "alertReStreamFail": false
      },
      "callbackEndpoint": "https://my-callback-endpoint",
      "envType": "REAL"
    },
    {
      "channelId": "ls-20201207133505-L691k",
      "channelName": "mychannel9",
      "instanceNo": 1542347,
      "qualitySetId": 5,
      "qualitySetName": "480p-set",
      "outputProtocol": "HLS, DASH",
      "channelStatus": "READY",
      "isRecording": false,
      "useDVR": false,
      "immediateOnAir": false,
      "timemachineMin": 0,
      "cdn": {
        "instanceNo": "1542348",
        "serviceName": "gcdn-ls-20201207133505-L691k",
        "statusName": "running",
        "cdnType": "GLOBAL_EDGE",
        "cdnDomain": "mycdn.edge.naverncp.com",
        "profileId": 299
      },
      "record": {
        "type": "MANUAL_UPLOAD",
        "accessControl": "PRIVATE"
      },
      "streamKey": "lcu0qwwkdj5lupdmmsz5w8e0b7dgrq0h",
      "publishUrl": "rtmp://live-station-rtmp-url",
      "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
      "totalPublishSeconds": 7795,
      "createdTime": 1607315706000,
      "alertOn": true,
      "recentPublishStartTime": 1607660432000,
      "alertOptions": {
        "alertChangeStatus": true,
        "alertVodUploadFail": false,
        "alertReStreamFail": false,
        "reStreamFailThreshold": 2
      },
      "callbackEndpoint": "https://my-callback-endpoint",
      "envType": "REAL"
    },
    {
      "channelId": "ls-20201207133353-wutob",
      "channelName": "mychannel10",
      "instanceNo": 1542345,
      "qualitySetId": 5,
      "qualitySetName": "480p-set",
      "outputProtocol": "HLS, DASH",
      "channelStatus": "READY",
      "isRecording": false,
      "useDVR": false,
      "immediateOnAir": false,
      "timemachineMin": 0,
      "cdn": {
        "instanceNo": "1542346",
        "serviceName": "gcdn-ls-20201207133353-wutob",
        "statusName": "running",
        "cdnType": "GLOBAL_EDGE",
        "cdnDomain": "mycdn.edge.naverncp.com",
        "profileId": 299,
        "regionType": "KOREA"
      },
      "record": {
        "type": "MANUAL_UPLOAD",
        "accessControl": "PRIVATE"
      },
      "streamKey": "5fn9ro9v6h9rgo7v6bdjn8e0a9yq84zw",
      "publishUrl": "rtmp://live-station-rtmp-url",
      "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
      "totalPublishSeconds": 0,
      "createdTime": 1607315633000,
      "alertOn": false,
      "alertOptions": {
        "alertChangeStatus": false,
        "alertVodUploadFail": false,
        "alertReStreamFail": false
      },
      "callbackEndpoint": "https://my-callback-endpoint",
      "envType": "REAL"
    }
  ],
  "total": 60
}

이 문서가 도움이 되었습니까?

What's Next

채널 설정 수정

요청
응답
예시

태그