NotAShelf
9e5eb41d39
Signed-off-by: NotAShelf <raf@notashelf.dev> Change-Id: I4806c58aa0a17f504c9312723ad770166a6a6964
114 lines
2.7 KiB
Markdown
Vendored
114 lines
2.7 KiB
Markdown
Vendored
# Streaming
|
|
|
|
HLS and DASH adaptive streaming
|
|
|
|
## Endpoints
|
|
|
|
### GET /api/v1/media/{id}/stream/dash/manifest.mpd
|
|
|
|
**Authentication:** Required (Bearer JWT)
|
|
|
|
#### Parameters
|
|
|
|
| Name | In | Required | Description |
|
|
| ---- | ---- | -------- | ------------- |
|
|
| `id` | path | Yes | Media item ID |
|
|
|
|
#### Responses
|
|
|
|
| Status | Description |
|
|
| ------ | ------------- |
|
|
| 200 | DASH manifest |
|
|
| 400 | Bad request |
|
|
| 401 | Unauthorized |
|
|
| 404 | Not found |
|
|
|
|
---
|
|
|
|
### GET /api/v1/media/{id}/stream/dash/{profile}/{segment}
|
|
|
|
**Authentication:** Required (Bearer JWT)
|
|
|
|
#### Parameters
|
|
|
|
| Name | In | Required | Description |
|
|
| --------- | ---- | -------- | ---------------------- |
|
|
| `id` | path | Yes | Media item ID |
|
|
| `profile` | path | Yes | Transcode profile name |
|
|
| `segment` | path | Yes | Segment filename |
|
|
|
|
#### Responses
|
|
|
|
| Status | Description |
|
|
| ------ | ------------------------- |
|
|
| 200 | DASH segment data |
|
|
| 202 | Segment not yet available |
|
|
| 400 | Bad request |
|
|
| 401 | Unauthorized |
|
|
|
|
---
|
|
|
|
### GET /api/v1/media/{id}/stream/hls/master.m3u8
|
|
|
|
**Authentication:** Required (Bearer JWT)
|
|
|
|
#### Parameters
|
|
|
|
| Name | In | Required | Description |
|
|
| ---- | ---- | -------- | ------------- |
|
|
| `id` | path | Yes | Media item ID |
|
|
|
|
#### Responses
|
|
|
|
| Status | Description |
|
|
| ------ | ------------------- |
|
|
| 200 | HLS master playlist |
|
|
| 401 | Unauthorized |
|
|
| 404 | Not found |
|
|
|
|
---
|
|
|
|
### GET /api/v1/media/{id}/stream/hls/{profile}/playlist.m3u8
|
|
|
|
**Authentication:** Required (Bearer JWT)
|
|
|
|
#### Parameters
|
|
|
|
| Name | In | Required | Description |
|
|
| --------- | ---- | -------- | ---------------------- |
|
|
| `id` | path | Yes | Media item ID |
|
|
| `profile` | path | Yes | Transcode profile name |
|
|
|
|
#### Responses
|
|
|
|
| Status | Description |
|
|
| ------ | -------------------- |
|
|
| 200 | HLS variant playlist |
|
|
| 400 | Bad request |
|
|
| 401 | Unauthorized |
|
|
| 404 | Not found |
|
|
|
|
---
|
|
|
|
### GET /api/v1/media/{id}/stream/hls/{profile}/{segment}
|
|
|
|
**Authentication:** Required (Bearer JWT)
|
|
|
|
#### Parameters
|
|
|
|
| Name | In | Required | Description |
|
|
| --------- | ---- | -------- | ---------------------- |
|
|
| `id` | path | Yes | Media item ID |
|
|
| `profile` | path | Yes | Transcode profile name |
|
|
| `segment` | path | Yes | Segment filename |
|
|
|
|
#### Responses
|
|
|
|
| Status | Description |
|
|
| ------ | ------------------------- |
|
|
| 200 | HLS segment data |
|
|
| 202 | Segment not yet available |
|
|
| 400 | Bad request |
|
|
| 401 | Unauthorized |
|
|
|
|
---
|