동영상 목록 - 동영상 폴더별 조회

미디어 보관함의 동영상 폴더에 포함된 동영상 목록을 조회합니다.

조회 결과에는 동영상 목록과 각 동영상의 상세 정보가 출력됩니다. ‘동영상 폴더 별 동영상 목록’은 동영상 원본의 저장 분류 값이며, 서비스용 인코딩 파일을 담보하지 않습니다. 따라서 서비스 배포에 필요한 정보는 ‘배포 패키지 별 동영상 목록’을 조회하는 것이 좋습니다.

🚧

과도한 API 요청이 발생하는 경우 사용량이 제한될 수 있습니다.

비정상적인 사용 패턴이 발견되는 경우 API 이용이 제한될 수 있습니다.

현재 제공 중인 API의 종류 및 내용은 더 나은 API 서비스 제공을 위해 변경 및 업데이트 될 수 있습니다.

Request URL

GET https://api.v4.wecandeo.com/info/videopack/folder/v1/videos.json?folderId={Folder ID}

Request Parameters

Parameter Name	Type	Description
folderId (Required)	Integer	미디어 보관함의 동영상 폴더 ID
searchItem	String	검색 옵션 title : 제목 series : 시리즈 author : 원작자 copyright : 저작권 content : 내용 tag : 태그 etc : 기타
keyword	String	검색 단어
sortItem	String	정렬 항목 id : 아이디 (default) title : 제목 duration : 재생시간 filesize : 파일크기
sortDirection	String	정렬 옵션 desc : 내림차순 asc : 오름차순
pageSize	Integer	조회 결과 페이지당 동영상 목록 수량
page	Integer	조회할 페이지 번호

Response Example

{
    "videoInfoList": {
        "apiVideoSearchOption": {
            "keyword": "wecandeo",
            "searchItem": "title",
            "sortItem": "id",
            "sortDirection": 1
        },
        "folderVideoList": [
            {
                "videoId": 23,
                "content": null,
                "duration": 59234,
                "cid": null,              	
                "accessKey": "PXqGis2mA8NoqTAlzWiiQ8Bii7PRhD2ByBI",
                "fileSize": 19999070,
                "thumbnailUrl": "https://{DOMAIN}/thumb/20230504/21/a86071a7-26b6-49f6-a027-35651309aca3_2ed87c28-6be2-464b-a7a0-999d609c30b2.jpg",
                "vHeight": 720,
                "vWidth": 1280,
                "title": "wecandeo",
                "cdate": "2023-05-04T12:35:18.000Z",
                "series": null,
                "author": null,
                "copyright": null,
                "rate": null,
                "etc": null,
                "vFramerate": 30,
                "encodingSuccess": null
            }
        ],
        "paging": {
            "page": 1,
            "pageSize": 10,
            "totalCount": 5,
            "totalPage": 1
        }
    }
}

Response Data Value

Name	Type	Description
videoId	Long	비디오 ID
accessKey	String	원본 키 (Access Key)
duration	Long	재생시간
fileSize	String	파일 사이즈
cid	String	사용자 정의 문자열 (ID) (최대 64 자리)
content	String	내용 정보
fileSize	Long	파일 용량
thumbnailUrl	String	비디오 대표 썸네일 URL
vHeight	Integer	영상 높이
vWidth	Integer	영상 폭
vFramerate	Float	FPS (Frames per second)
title	String	영상 제목
series	String	시리즈 정보
author	String	원작자 정보
copyright	String	저작권 정보
rate	String	관람등급 정보
etc	String	기타 정보
encodingSuccess	String	인코딩 여부 (Y/N)