Get a video information

This API can receive a video infomation for video unique id.

request a video information#

bash
curl -X GET \
     "https://develop.kokoon.cloud/kokoon/api/sr/v3/video/${vid}" \
     -H "Content-Type:application/json" \
     -H 'Authorization: eyJraWQiOiJPMGs5...eyJzdWIiOiIzN2U3NzYxM'

request parameter#

vid : video unique id.

response#

json
{
  "uid": "539e3480-929a-11ee-ada2-51e4bfe11414",
  "vid": "de5e9990-c0fb-11ee-961f-d12490e606ad",
  "pid": "00000000-0000-0000-0000-000000000000",
  "tid": "00000000-0000-0000-0000-000000000000",
  "created_time": "2024-02-01T12:17:32.699Z",
  "filename": "original.mp4",
  "size": 939073,
  "codec_name": "h264",
  "fps": "30/1",
  "duration": "10.000000",
  "nb_frames": "300",
  "bitrate": "739484",
  "width": 640,
  "height": 360,
  "download_cnt": 0,
  "expired_time": "2024-02-15T12:17:32.699Z",
  "state": "completed",
  "url": "https://sr-inner-api-storage-local.s3.amazonaws.com/video/539e3480-929a-11ee-ada2-51e4bfe11414/...",
  "thumb_url": "https://sr-inner-api-storage-local.s3.amazonaws.com/video/539e3480-929a-11ee-ada2-51e4bfe11414/...",
  "is_rotated": false,
  "is_interlaced": false,
  "last_category": null
}

response body field#

field	type	description
uid	string	user's unique id
vid	string	video unique id
pid	string	parent_id : if video file is original, parent_id is '00000000-0000-0000-0000-000000000000'. if video file is SR result, parent_id is original file's vid used when SR is requested.
tid	string	SR task_id : if video file is original, task_id is '00000000-0000-0000-0000-000000000000'. if video file is SR result, task_id is a unique task-id recevied when SR is requested.
created_time	string	video's created time.
filename	string	video's filename.
size	int	video's filesize.
codec_name	string	video's codec_name.
fps	string	video's fps(frame per second).
duration	string	video's duration.(seconds)
nb_frames	string	video's number of total frames.
bitrate	string	video's bitrate.(bits per second)
width	int	video's width.
height	int	video's height.
download_cnt	int	video's downloding count. We cannot figure out that a user really downloaded a original file with url. But we can provide a download-inc-count API. After a user really download a file with url, if call download-inc-count API, download_cnt will be increased.
expired_time	string	video's expired time. original video will be expired after 14day later from created_time.
state	string	video's state. In case of original file, state is always 'completed'. state : pending : SR video creation is requested. processing : SR video creation is in processing. completed : SR video creation is completed. error : SR video creation is failed.
url	url	video's url.
thumb_url	url	video's thumbnail url.
is_rotated	boolean	when true, it indicates that original video is rotated with +90 degree or -90 degree.
is_interlaced	boolean	when true, it indicates that video is interlaced.
last_category	string	last selected category in SR task.

error response#

video does not exist.

json
{
  "message": "fail to get result."
}