GET Live Video Custom Screens
Overview
The table below provides key details about the Get
method to receive Custom Screens for a specific Live Video.
GET Live Video Custom Screen | |
---|---|
Method | GET |
URL or Endpoint | /api/v1/projectId /live-video/videoId/ custom-screens |
Headers | Authorization |
Parameters | videoId, projectId |
The description of the URL parameter is as follows:
videoId URL Parameter | |
---|---|
URL Parameter Name | videoId |
Mandatory | Yes |
Type | string |
Description | Unique Id of the live video. |
projectId URL Parameter | |
---|---|
URL Parameter Name | projectId |
Mandatory | Yes |
Type | string |
Description | Unique Id of the project. |
Request Body
The request does not contain the request body.
Response
{
"success": true,
"errors": [],
"messages": [],
"result": [
{
"id": 593,
"type": 1,
"typeName": "Prelive",
"source": "https://cdn.vpplayer.tech/{projectId}/live-videos/{videoId}/default-screens/{customScreen}.jpg",
"sourcePath": "live-videos/{videoId}/default-screens/{customScreen}.jpg",
"mimeType": null,
"videoId": "{videoId}",
"playBackUrl": "",
"thumbnailUrl": "https://cdn.vpplayer.tech/{projectId}/live-videos/{videoId}/default-screens/{customScreen}.jpg",
"channelId": "{channelId}",
"projectId": null
},
{
"id": 594,
"type": 2,
"typeName": "End",
"source": "https://cdn.vpplayer.tech/{projectId}/live-videos/{videoId}/default-screens/{customScreen}.jpg",
"sourcePath": "live-videos/{videoId}/default-screens/{customScreen}.jpg",
"mimeType": null,
"videoId": "{videoId}",
"playBackUrl": "",
"thumbnailUrl": "https://cdn.vpplayer.tech/{projectId}/live-videos/{videoId}/default-screens/{customScreen}.jpg",
"channelId": "{channelId}",
"projectId": null
},
{
"id": 595,
"type": 3,
"typeName": "Pause",
"source": "https://cdn.vpplayer.tech/{projectId}/live-videos/{videoId}/default-screens/{customScreen}.jpg",
"sourcePath": "live-videos/{videoId}/default-screens/{customScreen}.jpg",
"mimeType": null,
"videoId": "{videoId}",
"playBackUrl": "",
"thumbnailUrl": "https://cdn.vpplayer.tech/{projectId}/live-videos/{videoId}/default-screens/{customScreen}.jpg",
"channelId": "{channelId}",
"projectId": null
},
{
"id": 596,
"type": 4,
"typeName": "Problem",
"source": "https://cdn.vpplayer.tech/{projectId}/live-videos/{videoId}/default-screens/{customScreen}.mp4",
"sourcePath": "live-videos/{videoId}/default-screens/{customScreen}.mp4",
"mimeType": null,
"videoId": "{videoId}",
"playBackUrl": "",
"thumbnailUrl": "https://cdn.vpplayer.tech/{projectId}/live-videos/{videoId}/default-screens/{customScreen}",
"channelId": "{channelId}",
"projectId": null
}
],
"resultInfo": null,
"statusCode": 200
}
Information about the fields that appear when you receive the response are displayed in the table below.
Field Name | Type | Description |
---|---|---|
success | bool | If the response is successful it will return true. Otherwise will return false. |
errors | array[] | Indicates if there was an error. |
messages | array[] | Returns the response message from back-end. |
result | array[Object] | Returns the response object. |
id | integer($int32) | Returns the unique identifier for the custom screen |
type | integer($int32) | Specifies the type of the custom screen. |
typeName | string | Name of the type for the custom screen |
source | string | The URL to access the custom screen image |
sourcePath | string($binary) | The relative path of the source file within the storage system |
mimeType | string | The mime type of the custom screen. |
videoId | string | The unique identifier of the video associated with the custom screen |
playbackUrl | string | The URL for the playback of the video |
thumbnailUrl | string | The URL to access the thumbnail image of the custom screen |
channelId | string | The unique identifier of the channel associated with the custom screen. |
projectId | string | The unique identifier of the project associated with the custom screen. |
resultInfo | string | Returns extra information about the result. |
statusCode | integer($int32) | Returns the HTTP Status Code. |
If the action is successful, the service sends back an HTTP 200 or 201 response.
Errors
For information about the errors that are common to all actions, see Common Errors:
HTTP Status Code 400: Bad Request
HTTP Status Code 401: Unauthorized
HTTP Status Code 403: Forbidden
HTTP Status Code 404: Result Not Found
HTTP Status Code 500: Internal Server Error
HTTP Status Code 503: Backend Fetch Failed