GET : API to Get all the recordings

GET

https://<appname>.metered.live/api/v1/recordings/room/:roomName

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

<roomName> - replace it with the name of the room for which you want the recordings

Description

This endpoint allows you to GET all the recordings for a room

Parameters

Parameters		Description	Required	Options
Query
secretKey	string	your secret key	yes	-
roomName	string	The name of the room for which you want the recordings	yes	-

Request Samples

cURL

cURL

curl --request GET \
--url 'https://appname.metered.live/api/v1/recordings/room/roomName?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 a (){
    try{
        const response = await axios.get('https://appname.metered.live/api/v1/recordings/room/roomName',
        {
        params: {
            secretKey: 'your_secret_key'
            }
        })
        console.log(response.data)
    } catch(error){
        console.log(error)
    }
}

Ruby

Ruby

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

url = URI("https://appname.metered.live/api/v1/recordings/room/roomName")

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://appname.metered.live/api/v1/recordings/room/roomName"

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://appname.metered.live/api/v1/recordings/room/roomName?secretKey={replace_this_with_your_secretKey}", 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

{
    "privacy": "public",
    "deleteOnExp": false,
    "autoJoin": false,
    "enableRequestToJoin": true,
    "enableChat": true,
    "enableScreenSharing": true,
    "joinVideoOn": true,
    "joinAudioOn": true,
    "ownerOnlyBroadcast": false,
    "enableRecording": false,
    "recordRoom": true,
    "ejectAtRoomExp": false,
    "lang": "en",
    "audioOnlyRoom": false,
    "recordComposition": true,
    "enableComposition": true,
    "compositionLayout": "grid",
    "compositionOrientation": "wide",
    "enableLiveStreaming": true,
    "enableRTMPOut": true,
    "enableWatermark": false,
    "watermarkPosition": "bottom_right",
    "archived": false,
    "_id": "61d32c83b6461676b7fcd5a0",
    "roomName": "ufuiwe",
    "rtmpOutURL": "rtmp://a.rtmp.youtube.com/live2/jidsfjisiojfwehfu",
    "ejectAfterElapsedTimeInSec": 0,
    "notBeforeUnixSec": null,
    "expireUnixSec": null,
    "app": "615c56b84eb9fab97ea18c75",
    "created": "2022-01-03T17:04:03.465Z",
    "__v": 0,
    "watermarkHeight": null,
    "watermarkWidth": null,
    "liveStreamKey": "jkfhskfshfuiwjwhuiwewiu"
}

400

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