api.video is the video infrastructure for product builders. Lightning fast video APIs for integrating, scaling, and managing on-demand & low latency live streaming features in your app.
- Project description
- Getting started
- Documentation
- Have you gotten use from this API client?
- Contribution
api.video's Java Go client streamlines the coding process. Chunking files is handled for you, as is pagination and refreshing your tokens.
go get github.com/apivideo/api.video-go-clientFor a more advanced usage you can checkout the rest of the documentation in the docs directory
package main
import (
"fmt"
"os"
apivideosdk "github.com/apivideo/api.video-go-client"
)
func main() {
//Connect to production environment
client := apivideosdk.ClientBuilder("YOUR_API_TOKEN").Build()
// if you rather like to use the sandbox environment:
// client := apivideosdk.SandboxClientBuilder("YOU_SANDBOX_API_TOKEN").Build()
//List Videos
//First create the url options for searching
opts := apivideosdk.VideosApiListRequest{}.
CurrentPage(1).
PageSize(25).
SortBy("publishedAt").
SortOrder("desc")
//Then call the List endpoint with the options
result, err := client.Videos.List(opts)
if err != nil {
fmt.Println(err)
}
for _, video := range result.Data {
fmt.Printf("%s\n", *video.VideoId)
fmt.Printf("%s\n", *video.Title)
}
//Upload a video
//First create a container
create, err := client.Videos.Create(apivideosdk.VideoCreationPayload{Title: "My video title"})
if err != nil {
fmt.Println(err)
}
//Then open the video file
videoFile, err := os.Open("path/to/video.mp4")
if err != nil {
fmt.Println(err)
}
//Finally upload your video to the container with the videoId
uploadedVideo, err := client.Videos.UploadFile(*create.VideoId, videoFile)
if err != nil {
fmt.Println(err)
}
//And get the assets
fmt.Printf("%s\n", *uploadedVideo.Assets.Hls)
fmt.Printf("%s\n", *uploadedVideo.Assets.Iframe)
}All URIs are relative to https://ws.api.video
client := apivideosdk.ClientBuilder("API_VIDEO_KEY").Build()
captionsApi := client.Captions| Method | HTTP request | Description |
|---|---|---|
| Delete | Delete /videos/{videoId}/captions/{language} | Delete a caption |
| List | Get /videos/{videoId}/captions | List video captions |
| Get | Get /videos/{videoId}/captions/{language} | Show a caption |
| Update | Patch /videos/{videoId}/captions/{language} | Update caption |
| Upload | Post /videos/{videoId}/captions/{language} | Upload a caption |
client := apivideosdk.ClientBuilder("API_VIDEO_KEY").Build()
chaptersApi := client.Chapters| Method | HTTP request | Description |
|---|---|---|
| Delete | Delete /videos/{videoId}/chapters/{language} | Delete a chapter |
| List | Get /videos/{videoId}/chapters | List video chapters |
| Get | Get /videos/{videoId}/chapters/{language} | Show a chapter |
| Upload | Post /videos/{videoId}/chapters/{language} | Upload a chapter |
client := apivideosdk.ClientBuilder("API_VIDEO_KEY").Build()
liveStreamsApi := client.LiveStreams| Method | HTTP request | Description |
|---|---|---|
| Delete | Delete /live-streams/{liveStreamId} | Delete a live stream |
| DeleteThumbnail | Delete /live-streams/{liveStreamId}/thumbnail | Delete a thumbnail |
| List | Get /live-streams | List all live streams |
| Get | Get /live-streams/{liveStreamId} | Show live stream |
| Update | Patch /live-streams/{liveStreamId} | Update a live stream |
| Create | Post /live-streams | Create live stream |
| UploadThumbnail | Post /live-streams/{liveStreamId}/thumbnail | Upload a thumbnail |
client := apivideosdk.ClientBuilder("API_VIDEO_KEY").Build()
playerThemesApi := client.PlayerThemes| Method | HTTP request | Description |
|---|---|---|
| Delete | Delete /players/{playerId} | Delete a player |
| DeleteLogo | Delete /players/{playerId}/logo | Delete logo |
| List | Get /players | List all player themes |
| Get | Get /players/{playerId} | Show a player |
| Update | Patch /players/{playerId} | Update a player |
| Create | Post /players | Create a player |
| UploadLogo | Post /players/{playerId}/logo | Upload a logo |
client := apivideosdk.ClientBuilder("API_VIDEO_KEY").Build()
rawStatisticsApi := client.RawStatistics| Method | HTTP request | Description |
|---|---|---|
| ListLiveStreamSessions | Get /analytics/live-streams/{liveStreamId} | List live stream player sessions |
| ListSessionEvents | Get /analytics/sessions/{sessionId}/events | List player session events |
| ListVideoSessions | Get /analytics/videos/{videoId} | List video player sessions |
client := apivideosdk.ClientBuilder("API_VIDEO_KEY").Build()
uploadTokensApi := client.UploadTokens| Method | HTTP request | Description |
|---|---|---|
| DeleteToken | Delete /upload-tokens/{uploadToken} | Delete an upload token |
| List | Get /upload-tokens | List all active upload tokens. |
| GetToken | Get /upload-tokens/{uploadToken} | Show upload token |
| CreateToken | Post /upload-tokens | Generate an upload token |
client := apivideosdk.ClientBuilder("API_VIDEO_KEY").Build()
videosApi := client.Videos| Method | HTTP request | Description |
|---|---|---|
| Delete | Delete /videos/{videoId} | Delete a video |
| Get | Get /videos/{videoId} | Show a video |
| GetStatus | Get /videos/{videoId}/status | Show video status |
| List | Get /videos | List all videos |
| Update | Patch /videos/{videoId} | Update a video |
| PickThumbnail | Patch /videos/{videoId}/thumbnail | Pick a thumbnail |
| UploadWithUploadToken | Post /upload | Upload with an upload token |
| Create | Post /videos | Create a video |
| Upload | Post /videos/{videoId}/source | Upload a video |
| UploadThumbnail | Post /videos/{videoId}/thumbnail | Upload a thumbnail |
client := apivideosdk.ClientBuilder("API_VIDEO_KEY").Build()
watermarksApi := client.Watermarks| Method | HTTP request | Description |
|---|---|---|
| Delete | Delete /watermarks/{watermarkId} | Delete a watermark |
| List | Get /watermarks | List all watermarks |
| Upload | Post /watermarks | Upload a watermark |
client := apivideosdk.ClientBuilder("API_VIDEO_KEY").Build()
webhooksApi := client.Webhooks| Method | HTTP request | Description |
|---|---|---|
| Delete | Delete /webhooks/{webhookId} | Delete a Webhook |
| Get | Get /webhooks/{webhookId} | Show Webhook details |
| List | Get /webhooks | List all webhooks |
| Create | Post /webhooks | Create Webhook |
- AccessToken
- AuthenticatePayload
- BadRequest
- BytesRange
- Caption
- CaptionsListResponse
- CaptionsUpdatePayload
- Chapter
- ChaptersListResponse
- Link
- LiveStream
- LiveStreamAssets
- LiveStreamCreationPayload
- LiveStreamListResponse
- LiveStreamSession
- LiveStreamSessionClient
- LiveStreamSessionDevice
- LiveStreamSessionLocation
- LiveStreamSessionReferrer
- LiveStreamSessionSession
- LiveStreamUpdatePayload
- Metadata
- NotFound
- Pagination
- PaginationLink
- PlayerSessionEvent
- PlayerTheme
- PlayerThemeAssets
- PlayerThemeCreationPayload
- PlayerThemeUpdatePayload
- PlayerThemesListResponse
- Quality
- RawStatisticsListLiveStreamAnalyticsResponse
- RawStatisticsListPlayerSessionEventsResponse
- RawStatisticsListSessionsResponse
- RefreshTokenPayload
- TokenCreationPayload
- TokenListResponse
- UploadToken
- Video
- VideoAssets
- VideoClip
- VideoCreationPayload
- VideoSession
- VideoSessionClient
- VideoSessionDevice
- VideoSessionLocation
- VideoSessionOs
- VideoSessionReferrer
- VideoSessionSession
- VideoSource
- VideoSourceLiveStream
- VideoSourceLiveStreamLink
- VideoStatus
- VideoStatusEncoding
- VideoStatusEncodingMetadata
- VideoStatusIngest
- VideoThumbnailPickPayload
- VideoUpdatePayload
- VideoWatermark
- VideosListResponse
- Watermark
- WatermarksListResponse
- Webhook
- WebhooksCreationPayload
- WebhooksListResponse
Please take a moment to leave a star on the client ⭐
This helps other users to find the clients and also helps us understand which clients are most popular. Thank you!
Since this API client is generated from an OpenAPI description, we cannot accept pull requests made directly to the repository. If you want to contribute, you can open a pull request on the repository of our client generator. Otherwise, you can also simply open an issue detailing your need on this repository.
