Streamings

Create live streaming

This endpoint allows you to create a new live streaming.

POSThttps://api.aiozstream.network/api/live_streams/:key_id/streamings

Parameters

key_id* The unique identifier of the live stream key

Headers

Authorization Bearer your_access_token_here

stream-public-key your_public_key_here

stream-secret-key your_secret_key_here

Body

title* The name of the live streaming

save Whether the live streaming should be saved after streaming (default: false)

qualities An array of quality config for the live streaming video (similar to create video)

Response

200: OK

curl --location --request POST 'https://api.aiozstream.network/api/live_streams/key_id/streamings' \
--header 'accept: application/json' \
--header 'Authorization: Bearer <YOUR_JWT_TOKEN>' \
--data-raw '{
    "title": "live_streaming_title",
    "save": true,
    "qualities": [
    {
      "resolution": "360p",
      "type": "hls",
      "container_type": "mpegts"
    },
    {
      "resolution": "720p",
      "type": "hls",
      "container_type": "mpegts"
    }
  ]
}'

List streamings

This endpoint retrieves a list of all your streamings.

GEThttps://api.aiozstream.network/api/live_streams/:key_id/streamings

Parameters

key_id* The unique identifier of the live streaming key

Headers

Authorization Bearer your_access_token_here

stream-public-key your_public_key_here

stream-secret-key your_secret_key_here

Response

200: OK

{
    "status": "success",
    "data": {
        "videos": [
            {
                "id": "streaming_id",
                "key_id": "key_id",
                "user_id": "user_id",
                "title": "streaming_title",
                "duration": 0,
                "assets": {
                    "thumbnail_url": "thumbnail_url",
                    "hls_url": "hls_url",
                    "iframe": "iframe",
                    "player_url": "player_url"
                },
                "save": true,
                "created_at": "2024-11-11T11:11:11.111111Z",
                "updated_at": "2024-11-11T11:11:11.111111Z",
                "status": "created",
                "video": {
                    "id": "video_id",
                    "user_id": "user_id",
                    "title": "video_title",
                    "description": "video_description",
                    "metadata": [
                        {
                            "key": "live_stream_id",
                            "value": "live_stream_id"
                        }
                    ],
                    "tags": null,
                    "qualities": null,
                    "captions": null,
                    "chapters": null,
                    "view": 0,
                    "player_theme": null,
                    "duration": 0,
                    "size": 0,
                    "is_mp4": false,
                    "is_public": true,
                    "status": "new",
                    "created_at": "2024-11-11T11:11:11.111111Z",
                    "updated_at": "2024-11-11T11:11:11.111111Z",
                    "assets": {
                        "source_url": "source_url",
                        "thumbnail_url": "thumbnail_url",
                        "hls_url": "hls_url",
                        "mp4_url": "mp4_url",
                        "iframe": "iframe",
                        "player_url": "player_url"
                    },
                    "player_theme_id": "player_theme_id"
                },
                "frame_rate": 0,
                "audio_bitrate": 0,
                "current_view": 0,
                "total_view": 0
            }
        ],
        "total": 1
    }
}

curl 'https://api.aiozstream.network/api/live_streams/:key_id/streamings' \
  -H 'accept: application/json, text/plain, */*' \
  -H 'authorization: Bearer <YOUR_JWT_TOKEN>' \

Update live streaming

This endpoint allows you to update the information of a live streaming.

PUThttps://api.aiozstream.network/api/live_streams/:key_id/streamings

Parameters

key_id* The unique identifier of the live streaming key

Headers

Authorization Bearer your_access_token_here

stream-public-key your_public_key_here

stream-secret-key your_secret_key_here

Body

title* The title of the live streaming

save Whether the live streaming should be saved after streaming (default: false)

Response

200: OK

curl --location --request PUT 'https://api.aiozstream.network/api/live_streams/key_id/streamings' \
--header 'accept: application/json' \
--header 'Authorization: Bearer <YOUR_JWT_TOKEN>' \
--data '{
  "title": "test",
  "save": true
}'

PreviousVideos NextLivestream Statistic