동영상 목록 - 배포 패키지별 조회

특정 배포 패키지에 포함된 동영상 목록을 조회합니다.

조회 결과에는 동영상 목록과 각 동영상의 상세 정보가 출력됩니다. 검색 옵션 및 페이지 옵션을 추가하면 특정 키워드가 포함된 목록만 출력하거나, 목록 수량의 단위를 나누어 출력할 수 있습니다.

🚧

  • 과도한 API 요청이 발생하는 경우 사용량이 제한될 수 있습니다.
  • 비정상적인 사용 패턴이 발견되는 경우 API 이용이 제한될 수 있습니다.
  • 현재 제공 중인 API의 종류 및 내용은 더 나은 API 서비스 제공을 위해 변경 및 업데이트 될 수 있습니다.

Request URL

GET https://api.v4.wecandeo.com/info/videopack/package/v1/videos.json?packageId={Package ID}

Request Parameters

Parameter NameTypeDescription
packageId (Required)Integer배포 패키지 ID
folderIdInteger폴더 ID
searchItemString검색 옵션

- title : 제목
- series : 시리즈
- author : 원작자
- copyright : 저작권
- content : 내용
- tag : 태그
- etc : 기타
keywordString검색 단어
sortItemString정렬 항목

- id : 아이디 (default)
- title : 제목
- duration : 재생시간
- filesize : 파일크기
sortDirectionString정렬 옵션

- desc : 내림차순
- asc : 오름차순
pageSizeInteger조회 결과 페이지당 동영상 목록 수량
pageInteger조회할 페이지 번호

Response Example

{
    "videoInfoList": {
        "apiVideoSearchOption": {
            "keyword": "wecan",
            "searchItem": "title",
            "sortItem": "id",
            "sortDirection": 1
        },
        "videoInfoList": [
            {
                "videoId": 21,
                "content": null,              	
                "duration": 59234,
                "vWidth": 1280,
                "vHeight": 720,
                "cdate": "2023-05-04T12:10:34.000Z",
                "title": "wecandeo",
                "series": null,
                "author": null,
                "copyright": null,
                "rate": null,
                "etc": null,
                "thumbnailUrl": "https://{DOMAIN}/thumb/20230504/21/34b68adb-58a2-415b-a8af-2fdd356476b9_0756d3ff-5c66-44a5-ade6-d270706361d1.jpg",
                "accessKey": "PXqGis2mA8NoqTAlzWiiQ8Bpip5Nsj5OXbW",
                "fileSize": 19999070,
                "vFramerate": 30,
                "cid": null,
                "videoKey": "ii8rFc1a4f74ip5dhYQbipiilBKIde28pWOt",
                "isPublished": "Y",
                "encodingSuccess": "Y"
            }
        ],
        "paging": {
            "page": 1,
            "pageSize": 10,
            "totalCount": 3,
            "totalPage": 1
        }
    }
}

Response Data Value

NameTypeDescription
videoIdString비디오 ID
contentString내용
durationLong재생시간
vWidthInteger영상 가로 사이즈
vHeightInteger영상 세로 사이즈
cdateString생성일자
titleString제목
seriesString시리즈
authorString원작자
copyrightString저작권
rateString관람등급
etcString기타
thumbnailUrlString썸네일 URL
accessKeyString원본 키 (Access Key)
fileSizeString파일 사이즈
vFramerateLong프레임 레이트
cidString사용자 정의 문자열 (ID) (최대 64 자리)
videoKeyString동영상 키
isPublishedString배포상태 ("Y" : 배포허용/ "N" : 배포중지)
encodingSuccessString인코딩 여부 (Y/N)