Get content metadata
GEThttps://api.one.blendvision.com/bv/playback/v1/contents
Fetches metadata associated with a specific content using the provided playback token for authorization.
- Returns a
401
/Unauthenticated
if the playback token is not valid. - Returns a
404
/NotFound
if the requested content metadata is not found.
Request
Header Parameters
This API should be invoked with playback token.
Responses
- 200
- 400
- 401
- 403
- 500
- default
A successful response.
- application/json
- Schema
- Example (from schema)
Schema
Possible values: Value must match regular expression ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Output only. The unique id of resource (live/vod).
Output only. The title of resource (live/vod).
Output only. The field indicating the live event is ended or not.
player_setting object
Output only. The unique id of tenant.
Output only. The field indicating the resource is in playable state or not.
Possible values: [RESOURCE_TYPE_LIVE_EVENT
, RESOURCE_TYPE_LIVE_EVENT_RECORDING
, RESOURCE_TYPE_VOD_EVENT
, RESOURCE_TYPE_AUDIO_EVENT
]
Output only. The type of resource.
Output only. The associate resource id, including vod_encoding id, it's used for later analytics.
Possible values: [RESOURCE_TYPE_VOD_ENCODING
]
Output only. The associate resource type. It is used for later analytics.
Output only. The last watched position, in seconds. The API caller can use this field to resume the playback from the last watched position.
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"title": "string",
"is_ended": true,
"player_setting": {
"template": "TEMPLATE_STANDALONE",
"features": [
{
"name": "FEATURE_NAME_PSE"
}
],
"share": {
"url": "string",
"show_iframe_tag": true
},
"description": "string",
"color": "string",
"cover_image_url": "string",
"default_image_url": "string",
"watermark": {
"position": "POSITION_BOTTOM_RIGHT",
"image_url": "string",
"text": "string",
"size": 0,
"offset": {
"x": 0,
"y": 0
}
}
},
"tenant_id": "string",
"playable": true,
"type": "RESOURCE_TYPE_LIVE_EVENT",
"assoc_resource_id": "string",
"assoc_resource_type": "RESOURCE_TYPE_VOD_ENCODING",
"last_watched_position": 0
}
A bad request response.
The code
is 3
means got an invalid argument. There are more HTTP status code mappings listed on here and gRPC code on here.
- application/json
- Schema
- Example (from schema)
Schema
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
A unauthenticated response.
The header authorization
was missing or unidentified.
- application/json
- Schema
- Example (from schema)
Schema
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
A forbidden response.
It means that the provided authorization
did not have enough permission to access the resource or the API.
- application/json
- Schema
- Example (from schema)
Schema
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
A server error response. There are more HTTP status code mappings listed on here.
- application/json
- Schema
- Example (from schema)
Schema
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
An unexpected error response.
- application/json
- Schema
- Example (from schema)
Schema
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Authorization: authorization
name: authorizationtype: apiKeydescription: Enter the token with Bearer schema prefix, eg. `Bearer <token-string>`in: header
- curl
- python
- go
- nodejs
- php
- CURL
curl -L 'https://api.one.blendvision.com/bv/playback/v1/contents' \
-H 'Accept: application/json' \
-H 'authorization: <API_KEY_VALUE>'