49 lines
2.4 KiB
Go
49 lines
2.4 KiB
Go
package api
|
|
|
|
import "time"
|
|
|
|
// CategoriesResponse is the body of GET /api/categories.
|
|
type CategoriesResponse struct {
|
|
Categories []string `json:"categories" example:"documentary,news"`
|
|
}
|
|
|
|
// PresignRequest is the body of POST /api/videos/presign.
|
|
type PresignRequest struct {
|
|
FileName string `json:"fileName" example:"interview-cut.mov"`
|
|
ContentType string `json:"contentType" enums:"video/mp4,video/quicktime" example:"video/quicktime"`
|
|
}
|
|
|
|
// PresignResponse is the body returned by POST /api/videos/presign.
|
|
type PresignResponse struct {
|
|
UploadURL string `json:"uploadUrl" example:"https://raw-uploads-bucket.s3.amazonaws.com/videos/a1b2....mov?X-Amz-Signature=..."`
|
|
Key string `json:"key" example:"videos/a1b2c3d4e5f6.mov"`
|
|
}
|
|
|
|
// CompleteRequest is the body of POST /api/videos.
|
|
type CompleteRequest struct {
|
|
Title string `json:"title" example:"Inside the Newsroom"`
|
|
Description string `json:"description" example:"A behind-the-scenes look at the evening bulletin."`
|
|
Categories []string `json:"categories" example:"documentary,news"`
|
|
Tags string `json:"tags" example:"media, press, riyadh"`
|
|
FileName string `json:"fileName" example:"interview-cut.mov"`
|
|
Key string `json:"key" example:"videos/a1b2c3d4e5f6.mov"`
|
|
}
|
|
|
|
// VideoResponse is a persisted video record as returned by POST /api/videos.
|
|
// Status carries the values of services.VideoStatus; the enums tag has to be
|
|
// widened by hand whenever that type gains a state.
|
|
type VideoResponse struct {
|
|
ID string `json:"id" example:"0199f3a1-7c2e-7b21-9f0d-1a2b3c4d5e6f"`
|
|
Title string `json:"title" example:"Inside the Newsroom"`
|
|
Description string `json:"description" example:"A behind-the-scenes look at the evening bulletin."`
|
|
Categories []string `json:"categories" example:"documentary,news"`
|
|
Tags string `json:"tags" example:"media, press, riyadh"`
|
|
FileName string `json:"fileName" example:"interview-cut.mov"`
|
|
StorageKey string `json:"storageKey" example:"videos/a1b2c3d4e5f6.mov"`
|
|
MediaConvertJobID string `json:"mediaConvertJobId" example:"1755300000000-abcdef"`
|
|
Status string `json:"status" enums:"processing,ready,failed" example:"processing"`
|
|
SizeBytes int64 `json:"sizeBytes" example:"60"`
|
|
CreatedAt time.Time `json:"createdAt"`
|
|
UpdatedAt time.Time `json:"updatedAt"`
|
|
}
|