Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

APIs.io Engineering Platform Stream Video Clipping API

The Stream Video Clipping API from APIs.io Engineering Platform — 1 operation(s) for stream video clipping.

This API exposes 1 operation across 1 path, and defines 22 schemas. It is described by OpenAPI 3.0.0, at version 2015-07-09.

Requests are made against 4 base URLs: http://apigateway.{region}.amazonaws.com, https://apigateway.{region}.amazonaws.com, http://apigateway.{region}.amazonaws.com.cn, https://apigateway.{region}.amazonaws.com.cn.

1 operations 1 paths 22 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2015-07-09
Base URL
https://{bucketname}.s3.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

APIs.io Engineering Platform Stream Video Clipping API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Stream Video Clipping 1
POST
/accounts/{account_id}/stream/clip
APIs.io Engineering Platform Clip videos given a start and end time
stream-video-clipping-clip-videos-given-a-start-and-end-time 1 param body → 4XX200

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are stream_clipping (15 properties), stream_videoClipStandard (9 properties), stream_api-response-common-failure (4 properties), stream_api-response-common (3 properties). Each schema is shown below with its type and property counts.

stream_playback
object
2 properties
stream_clipping
object
15 properties
stream_api-response-common
object
3 properties 3 required
stream_messages
array
stream_preview
string
The video's preview page URI. This field is omitted until encoding is complete.
stream_allowedOrigins
array
Lists the origins allowed to display the video. Enter allowed origin domains in an array and use for wildcard subdomains. Empty arrays allow the video to be vi…
stream_creator
string
A user-defined identifier for the media creator.
stream_clipping_created
string
The date and time the clip was created.
stream_maxDurationSeconds
integer
The maximum duration in seconds for a video upload. Can be set for a video that is not yet uploaded to limit its duration. Uploads that exceed the specified du…
stream_watermarkAtUpload
object
1 property
stream_media_metadata
object
A user modifiable key-value store used to reference other systems of record for managing videos.
stream_live_input_modified
string
The date and time the live input was last modified.
stream_thumbnailTimestampPct
number
The timestamp for a thumbnail image calculated as a percentage value of the video's duration. To convert from a second-wise timestamp to a percentage, divide t…
stream_account_identifier
string
The account identifier tag.
stream_clipResponseSingle
stream_videoClipStandard
object
9 properties 3 required
stream_api-response-common-failure
object
4 properties 4 required
stream_end_time_seconds
integer
Specifies the end time for the video clip in seconds.
stream_start_time_seconds
integer
Specifies the start time for the video clip in seconds.
stream_requireSignedURLs
boolean
Indicates whether the video can be a accessed using the UID. When set to true, a signed token must be generated with a signing key to view the video.
stream_clipped_from_video_uid
string
The unique video identifier (UID).
stream_media_state
string
Specifies the processing status for all quality levels for a video.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

engineering-platform-stream-video-clipping-api-openapi.yml Raw ↑