Create Libraries
post
Create Libraries
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.
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.
Resource URL
https://api.stb.gov.sg/media-management /libraries/v2
Header Parameters
| Name | Values | Description |
|---|---|---|
|
Content-Type
(required) |
Format of the request body sent. Accepts only application/json. |
Body Parameters
Example
JSON which holds all the properties of the Library to be created
Request Attributes
| Parameter Name | Type | Max Length | Description | Example |
|---|
Response Error Details
| HTTP Code | Description |
|---|---|
| 400 | Bad Request — Request was not accepted and could be due to malformed parameter (e.g. spelling error) or missing a required parameter. |
| 401 | Unauthorised — API key is invalid or was not provided. |
| 403 | Forbidden — API key does not have the permission to perform the request. |
| 404 | Resource Not Found — Requested resource (i.e. the resource URL) does not exist. |
| 405 | Method Not Allowed — The HTTP request method is not supported by the resource. |
| 406 | Not Acceptable — Requester's acceptable content type for the response does not match the content type returned by the resource. |
| 414 | Request URL Too Long — Request URL exceeded the maximum acceptable URL length. |
| 415 | Unsupported Media Type — Request's format is not supported by the resource. |
| 422 | Unprocessable Entity — Request was not accepted, often due to semantic errors, such as data format. |
| 500 | Server Errors — Something is not working on TIH's end, happened very rarely. |
Resource Summary
| Security | Content Type | Category |
|---|---|---|
|
application/json |
Libraries |
Working...