Laerdal Labs Video Management (1.0.0)

Download OpenAPI specification:Download

This API allows management of video files. There is the capability of generating a signed url for upload or playback, as well as requesting deletion of an uploaded video. Videos should first be uploaded via the signed url before playback or deletion endpoints are used.

An API key must be provided under the "Authentication" header for each request

Authentication

apiKey

Security Scheme Type API Key
Header parameter name: Authentication

video

Management of video files

Generate Upload URL

Request a signed S3 URL to upload a new video file

Authorizations:
apiKey (Requires an AWS Secret Name and Policy access to a shared secret)
Request Body schema: application/json

Optional file extension

extension
string

File Extension, defaults to "mp4"

Responses

Request samples

Content type
application/json
{
  • "extension": "string"
}

Response samples

Content type
application/json
{
  • "signedUrl": "string",
  • "videoAssetId": "213f6253-9413-4d31-b85c-9a2b325cc885"
}

Generate Multi-Part Upload URL

Request to upload a new video - returned temporary credentials for multi-part S3 upload

Authorizations:
apiKey (Requires an AWS Secret Name and Policy access to a shared secret)
Request Body schema: application/json

Optional file extension

extension
string

File Extension, defaults to "mp4"

Responses

Request samples

Content type
application/json
{
  • "extension": "string"
}

Response samples

Content type
application/json
{
  • "bucket": "string",
  • "key": "string",
  • "credentials": "string",
  • "videoAssetId": "213f6253-9413-4d31-b85c-9a2b325cc885"
}

Get All Playback URLs

Request signed s3 playback urls for all uploaded video files for a given videoAssetId

Authorizations:
apiKey (Requires an AWS Secret Name and Policy access to a shared secret)
path Parameters
videoAssetId
required
string <uuid>

ID of videos to return

query Parameters
hls
boolean

If set, return HLS playback URL

Responses

Response samples

Content type
application/json
{
  • "playbackUrls": [
    ]
}

Delete Video

Request deletion of a previously uploaded video file

Authorizations:
apiKey (Requires an AWS Secret Name and Policy access to a shared secret)
path Parameters
videoAssetId
required
string <uuid>

ID of video to delete

Responses

Response samples

Content type
application/json
{
  • "videoAssetId": "213f6253-9413-4d31-b85c-9a2b325cc885"
}

Get Single Playback URL

Request a single signed s3 playback url for a previously uploaded video file

Authorizations:
apiKey (Requires an AWS Secret Name and Policy access to a shared secret)
path Parameters
videoAssetId
required
string <uuid>

ID of a video to return

query Parameters
hls
boolean

If set, return HLS playback URL

Responses

Response samples

Content type
application/json
{
  • "playbackUrl": "string"
}

sprites

Get Single Sprite URL

Request a single S3 signed URL for the first sprite in a preivously uploaded video file

Authorizations:
apiKey (Requires an AWS Secret Name and Policy access to a shared secret)
path Parameters
recordedFileId
required
string <uuid>

ID of Video to access sprite for

Responses

Response samples

Content type
application/json
{
  • "frameDuration": 0,
  • "framesPerSprite": 0,
  • "frameWidth": 0,
  • "frameHeight": 0,
  • "signedSpriteUrl": "string"
}