Skip to main content

Room Manager

App for Initial Development​

The default Sandbox App comes with an HTTP server called Room Manager. It allows you to start working on the Client App without having to set up an actual backend. However, for production purposes, you need to bring your own backend using our Server SDKs. Production apps don't have a corresponding Room Manager.

ROOM MANAGER IS NOT SAFE FOR PRODUCTION

Room Manager doesn't implement any form of authentication. Anyone using the same room name and peer name will receive the same Peer Token!

For a production environment, make sure to set up your own backend using our Server SDKs and authenticate the client on your own.

Why Should I Use It?​

If you're a frontend developer and you want to quickly test your app, you can use the Room Manager to create a room and access it. This way, you can start building your app without having to deploy any server-side logic.

note

When moving to production, the only change you will need to make is to retrieve the peer token from your backend instead of the Room Manager.

tip

The Room Manager source code is available as an example app in the js-server-sdk repository. It can be used as a reference for building your backend.

How Do I Use It?​

Simply log in to your Fishjam Dashboard and open the Sandbox App. You will see your Room Manager URL there. Now you need to add roomName and peerName query params to build a URL for the GET request.

Example GET Request URL​

https://fishjam.io/api/v1/connect/<YOUR_APP_UUID>/room-manager?roomName=foo&peerName=bar
note

YOUR_APP_UUID is your unique ID. Anyone who knows that ID can join your rooms. To reset this ID, you have to open the Sandbox App, press Settings, and Reset App.

Example Response​

{
  "peerToken": "<PEER_TOKEN>",
  "url": "wss://fishjam.io/api/v1/connect/<YOUR_APP_UUID>",
  "room": {
    "id": "<SOME_ID>",
    "name": "foo"
  },
  "peer": {
    "id": "<SOME_ID>",
    "name": "bar"
  }
}