특정 영상의 재생 가능한 URL을 조회합니다.
플레이어가 포함된 iframe을 반환하는 ‘영상 iframe 호출 API’와는 달리 이 API는 영상 원본의 직접적인 링크를 제공합니다.
| 이름 | 필수/선택 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| Authorization | 필수 | string | API 인증 키 | Authorization: Bearer your-api-key |
API 인증 키는 [웹관리자 접속 > 워크스페이스 > 설정 > API 관리]에서 생성한 API 키입니다.
반드시 API 키 앞에 ‘Bearer ‘를 추가해야 인증 처리에 이상이 없습니다. | | Version | 필수 | string | API 버전 | Version: 2025-09-14
반드시 올바른 Version을 명시해야 API 이용에 이상이 없습니다. |
| 이름 | 필수/선택 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| videoCode | 필수 | string | 영상 촬영 코드 |
<https://api.realpacking.com/v3/videos/videoCode12345/playback-url>
| 이름 | 필수/선택 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| generation-type | 선택 | string | 생성 유형 | generation-type이 요청되지 않는 경우 요청한 영상 촬영 코드(videoCode)를 가진 모든 개별 영상에 대해 영상 재생 URL을 제공합니다. 따라서 해당 영상 촬영 코드에 대해 영상이 N개인 경우 영상 재생 URL은 N개가 제공됩니다. (N ≥ 1) |
generation-type을 요청할 경우 값으로는 latest만 허용합니다.
latest: 요청한 영상 촬영 코드(videoCode)를 가진 영상 중 가장 최신 영상 1건에 대한 영상 재생 URL 1개를 제공합니다. |
<https://api.realpacking.com/v3/videos/videoCode12345/playback-url?generation-type=latest>
No Request Body Required
| 이름 | 필수/선택 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| message | 필수 | string | http status message | |
| data | 필수 | map | 결과 데이터 | |
| data.videoCode | 필수 | string | 영상 촬영코드 | |
| data.urlData | 필수 | map[] | 영상 url 리스트 | |
| data.urlData[i].url | 필수 | string | 영상 url | |
| data.urlData[i].videoId | 필수 | string | 영상 고유 ID | |
| data.urlData[i].recordedDate | 필수 | string | 영상 촬영일시 | 형식: YYYY-MM-DDThh:mm:ss+00:00 (ISO8601) |