GET : API to Get Currently Broadcasting Rooms

GET

    https://<appname>.metered.live/api/v1/realtimelivestreaming/rooms/broadcasting

<appname> - replace it the name of your app.

Description

This endpoint list all the rooms that are currently broadcasting.

Parameters

Parameters		Description	Required	Options
Query
secretKey	string	your secret key	yes	-

Request Samples

cURL

cURL

curl --request GET \
--url https://yourapp.metered.live/api/v1/realtimelivestreaming/rooms/broadcasting?secretKey={replace_this_with_your_secretKey} \
--header 'Accept: application/json'

NodeJs

NodeJs (Axios)

//We are using axios to send requests in our example
const axios = require('axios');

async function  (){
    try{
        const response = await axios.get('https://appname.metered.live/api/v1/realtimelivestreaming/rooms/broadcasting',
        {
        params: {
            secretKey: 'your_secret_key'
            }
        })
        console.log(response)
    } catch(error){
        console.log(error)
    }
}

Ruby

Ruby

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://yourapp.metered.live/api/v1/realtimelivestreaming/rooms/broadcasting")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Accept"] = 'application/json'

response = http.request(request)
puts response.read_body

Python

Python

import requests

url = "https://yourapp.metered.live/api/v1/realtimelivestreaming/rooms/broadcasting"

headers = {"Accept": "application/json"}

response = requests.request("GET", url, headers=headers)

print(response.text)

Go

Go

package main

import (
    "fmt"
    "io/ioutil"
    "log"
    "net/http"
)

func main() {
    client := &http.Client{}
    req, err := http.NewRequest("GET", "https://yourapp.metered.live/api/v1/realtimelivestreaming/rooms/broadcasting", nil)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Accept", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

Responses

200

[{
"_id": "6104093bb01b5311ee818280",
"app": "6071e1de0a0218674134a24e",
"room": {
    "_id": "60eef8020e3b10094cf4c9de",
    "privacy": "public",
    "deleteOnExp": false,
    "autoJoin": false,
    "enableKnocking": false,
    "enableChat": true,
    "enableScreenSharing": true,
    "joinVideoOn": true,
    "joinAudioOn": true,
    "ownerOnlyBroadcast": false,
    "enableRecording": false,
    "ejectAtRoomExp": true,
    "ejectAfterElapsedTimeInSec": 0,
    "lang": "en",
    "archived": false,
    "roomName": "eject-test",
    "app": "6071e1de0a0218674134a24e",
    "created": "2021-07-14T14:43:14.578Z",
    "expireUnixSec": null,
    "notBeforeUnixSec": null
},
"startTime": 1627654459,
"state": "active"
}]

400

{
    "success": false,
    "message": "Invalid request"
}