Minitube API (2.1.0)

Download OpenAPI specification:Download

Kevin Del Castillo Ramirez: quebin31@gmail.com

Create a new video.

Generates and returns a new video id and a presigned URL to put the video on the corresponding S3 bucket. In order to upload the video using the presigned URL you must sent a request with the following contents:

Raw video data (binary) must be included in the request body.
HTTP method must be PUT.
Header X-Amz-ACL must be public-read.
Header Content-Type must be video/mp4, therefore only mp4 videos are accepted.

Responses

Response samples

200
500

Content type

application/json

{"video_id": "string",
"presigned_url": "http://example.com"
}

Generate video thumbnail.

Request thumbnail generation for the specified video id and the given video timestamp in seconds, this will save the generated thumbnail in the corresponding S3 bucket, detect labels with Rekognition and save them in DynamoDB.

Request Body schema: application/json

Video id and timestamp.

video_id	string Video id.
timestamp	number <seconds> The timestamp where the thumbnail will be generated.

Responses

Request samples

Payload

Content type

application/json

{"video_id": "string",
"timestamp": 0
}

Response samples

200
400
500

Content type

application/json

{"labels": ["string"
]
}

Search videos with maching labels.

Search videos with matching labels specified in the query parameter, these are internally transformed to lower case.

query Parameters

query

string

Query string with space separated labels.

Responses

Response samples

200
400
500

Content type

application/json

{"videos": [{"labels": ["string"
],
"thumbnail_url": "http://example.com",
"preview_url": "http://example.com",
"video_url": "http://example.com"
}
]
}