diff --git a/docs/transcoding-service/get-transcoding-job-details.md b/docs/transcoding-service/get-transcoding-job-details.md index a675c7df..705f43cc 100644 --- a/docs/transcoding-service/get-transcoding-job-details.md +++ b/docs/transcoding-service/get-transcoding-job-details.md @@ -1,5 +1,5 @@ --- -sidebar_position: 3 +sidebar_position: 4 --- # Get Transcoding Job detail diff --git a/docs/transcoding-service/list-all-transcoding-jobs.md b/docs/transcoding-service/list-all-transcoding-jobs.md new file mode 100644 index 00000000..84bb67a1 --- /dev/null +++ b/docs/transcoding-service/list-all-transcoding-jobs.md @@ -0,0 +1,70 @@ +--- +sidebar_position: 3 +--- +# List all Transcoding Jobs + +To list all transcoding jobs, make a GET request to the following API endpoint, with the [authentication Header](../server-api/authentication.md). + +```base +https://app.tpstreams.com/api/v1//transcoding_jobs/ +``` + +Replace `` with your organization's unique identifier. + +### Query Parameters + +You can filter and order the list of transcoding jobs using the following query parameters: + +| Parameter | Type | Description | +| :--- | :--- | :--- | +| `status` | string | Filter jobs by status. You can provide multiple statuses by repeating the parameter.
Options: `queued`, `transcoding`, `completed`, `error`. | +| `enable_drm` | boolean | Filter jobs by whether DRM is enabled (`true`) or disabled (`false`). | +| `created_from` | string | Filter jobs created on or after this date and time (ISO 8601 format). | +| `created_to` | string | Filter jobs created on or before this date and time (ISO 8601 format). | +| `ordering` | string | Order the jobs by creation time.
Options: `-created` (Latest first), `created` (Oldest first). | + +#### Example request with filters +`https://app.tpstreams.com/api/v1//transcoding_jobs/?status=completed&enable_drm=true&created_from=2023-04-20T00:00:00Z&ordering=-created` + +### Sample Response + +The response is paginated and contains a list of transcoding jobs. + +```json +{ + "count": 42, + "next": "https://app.tpstreams.com/api/v1//transcoding_jobs/?page=2", + "previous": null, + "results": [ + { + "id": "5KQfnXCg8Qh", + "resolutions": [ + "240p", + "480p" + ], + "video_duration": 120, + "status": "completed", + "input_url": "https://example.com/input-video.mp4", + "output_path": "s3://example-bucket/path/?access_key=&secret_key=®ion=", + "start_time": "2023-04-20T23:20:06.034924+12:00", + "end_time": "2023-04-20T23:40:06.034924+12:00", + "error_message": null, + "enable_drm": true + }, + { + "id": "7XkLp9mN2O", + "resolutions": [ + "720p" + ], + "video_duration": 300, + "status": "queued", + "input_url": "https://example.com/another-video.mp4", + "output_path": "s3://example-bucket/another-path/?access_key=&secret_key=®ion=", + "start_time": null, + "end_time": null, + "error_message": null, + "enable_drm": false + } + ] +} +``` diff --git a/docs/transcoding-service/transcoding-cancelation.md b/docs/transcoding-service/transcoding-cancelation.md index 4aac1d51..9464dcba 100644 --- a/docs/transcoding-service/transcoding-cancelation.md +++ b/docs/transcoding-service/transcoding-cancelation.md @@ -1,5 +1,5 @@ --- -sidebar_position: 4 +sidebar_position: 5 --- # Cancel Transcoding Job diff --git a/docs/transcoding-service/transcoding-service-introduction.md b/docs/transcoding-service/transcoding-service-introduction.md index be8440b8..d54f29b0 100644 --- a/docs/transcoding-service/transcoding-service-introduction.md +++ b/docs/transcoding-service/transcoding-service-introduction.md @@ -9,5 +9,6 @@ Welcome to the Transcoding as a Service documentation! This guide is your gatewa Refer the documentation below for more information. - [Transcode a Video](transcode-a-video) +- [List all Transcoding Jobs](list-all-transcoding-jobs) - [Get Transcoding Job Details](get-transcoding-job-details) - [Cancel Transcoding Job](transcoding-cancelation)