특정 배포 패키지에 포함된 동영상 목록을 조회합니다.
조회 결과에는 동영상 목록과 각 동영상의 상세 정보가 출력됩니다. 검색 옵션 및 페이지 옵션을 추가하면 특정 키워드가 포함된 목록만 출력하거나, 목록 수량의 단위를 나누어 출력할 수 있습니다.
- 과도한 API 요청이 발생하는 경우 사용량이 제한될 수 있습니다.
- 비정상적인 사용 패턴이 발견되는 경우 API 이용이 제한될 수 있습니다.
- 현재 제공 중인 API의 종류 및 내용은 더 나은 API 서비스 제공을 위해 변경 및 업데이트 될 수 있습니다.
Request URL
GET https://api.v4.wecandeo.com/info/videopack/package/v1/videos.json?packageId={Package ID}
Request Parameters
Parameter Name | Type | Description |
---|---|---|
packageId (Required) | Integer | 배포 패키지 ID |
folderId | 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": "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
Name | Type | Description |
---|---|---|
videoId | String | 비디오 ID |
content | String | 내용 |
duration | Long | 재생시간 |
vWidth | Integer | 영상 가로 사이즈 |
vHeight | Integer | 영상 세로 사이즈 |
cdate | String | 생성일자 |
title | String | 제목 |
series | String | 시리즈 |
author | String | 원작자 |
copyright | String | 저작권 |
rate | String | 관람등급 |
etc | String | 기타 |
thumbnailUrl | String | 썸네일 URL |
accessKey | String | 원본 키 (Access Key) |
fileSize | String | 파일 사이즈 |
vFramerate | Long | 프레임 레이트 |
cid | String | 사용자 정의 문자열 (ID) (최대 64 자리) |
videoKey | String | 동영상 키 |
isPublished | String | 배포상태 ("Y" : 배포허용/ "N" : 배포중지) |
encodingSuccess | String | 인코딩 여부 (Y/N) |