diff --git a/docs/how-to/backend/server-setup.mdx b/docs/how-to/backend/server-setup.mdx index 356c9d72..b3f37d85 100644 --- a/docs/how-to/backend/server-setup.mdx +++ b/docs/how-to/backend/server-setup.mdx @@ -61,9 +61,11 @@ Let's setup everything you need to start communicating with a Fishjam instance. First of all, view your app in the [**Fishjam developer panel**](https://fishjam.io/app) and copy your **Fishjam ID** and the **Management Token**. They are required to proceed. Now, we are ready to dive into the code. +`FishjamClient.create` constructs the client and pings the Fishjam backend with the supplied credentials, so a bad `fishjamId` or `managementToken` fails at startup instead of on the first room operation. + - + ```ts process.env.FISHJAM_ID = "aaa"; process.env.FISHJAM_MANAGEMENT_TOKEN = "bbb"; @@ -71,10 +73,14 @@ They are required to proceed. Now, we are ready to dive into the code. // ---cut--- import { FishjamClient } from '@fishjam-cloud/js-server-sdk'; - const fishjamId = process.env.FISHJAM_ID; - const managementToken = process.env.FISHJAM_MANAGEMENT_TOKEN; + let fishjamClient = await FishjamClient.create({ + fishjamId: process.env.FISHJAM_ID!, + managementToken: process.env.FISHJAM_MANAGEMENT_TOKEN!, + }); - const fishjamClient = new FishjamClient({ fishjamId, managementToken }); + // The above is roughly equivalent to: + fishjamClient = new FishjamClient({ ... }); + await fishjamClient.checkCredentials(); ``` @@ -85,10 +91,14 @@ They are required to proceed. Now, we are ready to dive into the code. import os from fishjam import FishjamClient - fishjam_id = os.environ["FISHJAM_ID"] - management_token = os.environ["FISHJAM_MANAGEMENT_TOKEN"] + fishjam_client = FishjamClient.create_and_verify( + fishjam_id=os.environ["FISHJAM_ID"], + management_token=os.environ["FISHJAM_MANAGEMENT_TOKEN"], + ) - fishjam_client = FishjamClient(fishjam_id, management_token) + # The above is roughly equivalent to: + fishjam_client = FishjamClient(...) + fishjam_client.check_credentials() ``` diff --git a/packages/js-server-sdk b/packages/js-server-sdk index 078f2496..0da64e85 160000 --- a/packages/js-server-sdk +++ b/packages/js-server-sdk @@ -1 +1 @@ -Subproject commit 078f24967485d472cccb3de0de191adb81509a38 +Subproject commit 0da64e85b58bd8e73f1857b2594c2bd14bd35ba9 diff --git a/packages/python-server-sdk b/packages/python-server-sdk index c66f08f3..f87098ee 160000 --- a/packages/python-server-sdk +++ b/packages/python-server-sdk @@ -1 +1 @@ -Subproject commit c66f08f330f95b1648076acd63fe4f178dc52ba4 +Subproject commit f87098ee792a4dbe0eed6725677eb3388ccc2834