Media Provider API

QUICK TIP

Wish to contribute your media to TIH? Learn how to do so by referring API User Journey - Media.
You will also need an OAuth key to get started

.

Documents

Method
Description

POST

Create Documents

https://api.stb.gov.sg/media-management/documents/v2

Allow the creation of a Document metadata.Approach is to create a Library using Create Library API and retrieve the libraryUuid, prior to creating a Document metadata. Once the Document metadata has been created, proceed to upload the document asset using Upload Media Files API.To create successfully, the following input parameters are mandatory: name, category, subCategory, tags, libraryUuid and mediaType.

DELETE

Delete Documents

https://api.stb.gov.sg/media-management/documents/v2/{uuid}

Allow the deletion of an existing Document through the use of a uuid. The acronym for unique identifier is uuid. This uuid is created when you submit a media content. This can be found in API JSON response. If you have not documented the uuid, you can fetch it by using Search Media By Keyword or UUIDs API.

PUT

Update Documents

https://api.stb.gov.sg/media-management/documents/v2/{uuid}

Allow an existing Document to be updated through the use of a unique identifier. The acronym for unique identifier is uuid. This uuid is created when you submit a media content. This can be found in API JSON response. If you have not documented the uuid, you can fetch it by using Search Media By Keyword or UUIDs API.

Images

Method
Description

POST

Create Images

https://api.stb.gov.sg/media-management/images/v2

Allow the creation of a Image metadata.Approach is to create a Library using Create Library API and retrieve the libraryUuid, prior to creating a Image metadata. Once the Image metadata has been created, proceed to upload the image asset using Upload Media Files API.To create successfully, the following input parameters are mandatory: name, category, subCategory, tags, libraryUuid and mediaType.

DELETE

Delete Images

https://api.stb.gov.sg/media-management/images/v2/{uuid}

Allow the deletion of an existing Image through the use of a uuid. The acronym for unique identifier is uuid. This uuid is created when you submit a media content. This can be found in API JSON response. If you have not documented the uuid, you can fetch it by using Search Media By Keyword or UUIDs API.

PUT

Update Images

https://api.stb.gov.sg/media-management/images/v2/{uuid}

Allow an existing Image to be updated through the use of a unique identifier. The acronym for unique identifier is uuid. This uuid is created when you submit a media content. This can be found in API JSON response. If you have not documented the uuid, you can fetch it by using Search Media By Keyword or UUIDs API.

Libraries

Method
Description

POST

Create Libraries

https://api.stb.gov.sg/media-management/libraries/v2

Allow the creation of a Library.Approach to contributing media is to create a library first and, associate the media with the library. The libraryUuid (a unique identifier for the library) generated in the response of this API would be required in the next step to create a media (e.g. document, image, video).To create successfully, the following input parameters are mandatory: name, category, subCategory and tags.

DELETE

Delete Libraries

https://api.stb.gov.sg/media-management/libraries/v2/{uuid}

Allow the deletion of an existing Library through the use of a uuid. The acronym for unique identifier is uuid. This uuid is created when you submit a media content. This can be found in API JSON response. If you have not documented the uuid, you can fetch it by using Search Libraries By Keyword or UUIDs API.

PUT

Update Libraries

https://api.stb.gov.sg/media-management/libraries/v2/{uuid}

Allow an existing Library to be updated through the use of a unique identifier. The acronym for unique identifier is uuid. This uuid is created when you submit a media content. This can be found in API JSON response. If you have not documented the uuid, you can fetch it by using Search Libraries By Keyword or UUIDs API.

Videos

Method
Description

POST

Create Videos

https://api.stb.gov.sg/media-management/videos/v2

Allow the creation of a Video metadata.Approach is to create a Library using Create Library API and retrieve the libraryUuid, prior to creating a Video metadata. Once the Video metadata has been created, proceed to upload the video asset using Upload Media Files API.To create successfully, the following input parameters are mandatory: name, category, subCategory, tags, libraryUuid and mediaType.

DELETE

Delete Videos

https://api.stb.gov.sg/media-management/videos/v2/{uuid}

Allow the deletion of an existing Video through the use of a uuid. The acronym for unique identifier is uuid. This uuid is created when you submit a media content. This can be found in API JSON response. If you have not documented the uuid, you can fetch it by using Search Media By Keyword or UUIDs API.

PUT

Update Videos

https://api.stb.gov.sg/media-management/videos/v2/{uuid}

Allow an existing Video to be updated through the use of a unique identifier. The acronym for unique identifier is uuid. This uuid is created when you submit a media content. This can be found in API JSON response. If you have not documented the uuid, you can fetch it by using Search Media By Keyword or UUIDs API.

Upload

Method
Description

POST

Upload Media File

https://api.stb.gov.sg/media-management/upload/v2/{uuid}

To upload actual content of the Media files, using the uuid generated from creating the Image, Video and Document metadata.