View short-clip information
- Print
- PDF
View short-clip information
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
An API to view short-clip information of Live Station. Provides the short-clip list view API to view short-clip list to view information on short-clips.
Requests
GET https://livestation.apigw.ntruss.com/api/v2/channels/{channelId}/shortclip/{id}
Request headers
| Header name | Required | Description |
|---|---|---|
| x-ncp-apigw-timestamp | YES | Time elapsed since January 1, 1970 00:00:00 UTC in milliseconds. The request is considered invalid if the time difference compared to the API Gateway server is 5 minutes or longerx-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | YES | Access key ID value issued from NAVER Cloud Platform portalx-ncp-iam-access-key:{Sub Account Access Key} |
| x-ncp-apigw-signature-v2 | YES | Signature encrypted with the access key ID value and secret keyx-ncp-apigw-signature-v2:{API Gateway Signature} |
| Content-Type | YES | Specifies the request body content type as application/jsonContent-Type: application/json |
| x-ncp-region_code | YES | Region code (KR) |
Responses
| Field name | Type | Description | Note |
|---|---|---|---|
| channelId | String | Channel ID used in creating short-clip | |
| snapshotId | Integer | Snapshot ID used in creating short-clip | |
| shortclip | Object | Short-clip object | |
| shortclip.id | Integer | Short-clip ID | |
| shortclip.status | String | Short-clip status | CREATING,COMPLETED,PROCESSING_FAIL,UPLOAD_FAIL |
| shortclip.output | Object | Information in which the created short-clip is to be stored | |
| shortclip.output.accessControl | String | Option which specifies the scope of disclosure of the Object Storage Bucket in which the created short-clip is to be stored Default: PRIVATE | PRIVATE,PUBLIC_READ |
| shortclip.output.bucketName | String | Bucket name of the Object Storage in which the created short-clip is to be stored | |
| shortclip.output.fileName | String | File name of the created short-clip | |
| shortclip.output.filePath | String | filePath of the Object Storage in which the created short-clip is to be stored filePaths must start with "/" | |
| shortclip.createdTime | Integer | Time of creation of the created short-clip file | |
| shortclip.updatedTime | Integer | Update time of the created short-clip file | |
| shortclip.fileSize | Integer | File size of the created short-clip | |
| shortclip.duration | Integer | Playback time of the created short-clip |
Examples
Response examples
HTTP/1.1 200 OK
Server: nginx
Date: Fri, 26 Jun 2022 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4
{
"content": {
"channelId": "ls-20220623115623-fHnXy",
"snapshotId": 1047,
"shortclip": {
"id": 1060,
"status": "CREATING",
"createdTime": 1655979377666,
"updatedTime": 1655979377666,
"output": {
"accessControl": "PRIVATE",
"bucketName": "myTestBucket",
"filePath": "/",
"fileName": "1024-1655290646131.mp4"
}
}
}
}
Was this article helpful?