Streaming live v2

docusaurus.config.ts

@@ -408,9 +408,6 @@ const config: Config = {
           if (existingPath.startsWith('/theoplayer/how-to-guides/web/uplynk/')) {
             return [existingPath.replace('/theoplayer/how-to-guides/web/uplynk/', '/theoplayer/how-to-guides/miscellaneous/verizon-media/')];
           }
-          if (existingPath.startsWith('/theolive/playback/web/')) {
-            return [existingPath.replace('/theolive/playback/web/', '/theoplayer/how-to-guides/web/theolive/')];
-          }
           return undefined;
         },
       } satisfies ClientRedirectsPlugin.Options,
@@ -614,12 +611,11 @@ const config: Config = {
           docsPluginId: 'theoplayer',
           position: 'right',
         },
-        // TODO: Enable theolive version dropdown when v2 docs are finalized
-        // {
-        //   type: 'docsVersionDropdown',
-        //   docsPluginId: 'theolive',
-        //   position: 'right',
-        // },
+        {
+          type: 'docsVersionDropdown',
+          docsPluginId: 'theolive',
+          position: 'right',
+        },
       ],
     },
     footer: {

sidebarsTheolive.ts

@@ -5,57 +5,82 @@ const sidebars: SidebarsConfig = {
   theolive: [
     'index',
     'getting-started',
+    'manage-team',
+    'architecture',
     {
       type: 'category',
-      label: 'Contribution',
+      label: 'Channel',
+      customProps: {
+        icon: '📺',
+      },
+      description: 'Configure channel-level settings and optional features.',
+      link: { type: 'generated-index', slug: 'channel' },
+      items: [{ type: 'autogenerated', dirName: 'channel' }],
+    },
+    {
+      type: 'category',
+      label: 'Ingest',
       customProps: {
         icon: '📡',
       },
-      description: 'THEOlive Contribution / Publishing guides',
+      description: 'Get your live media into the platform.',
       link: { type: 'generated-index', slug: 'contribution' },
       items: [{ type: 'autogenerated', dirName: 'contribution' }],
     },
     {
       type: 'category',
-      label: 'Platform',
+      label: 'Media Engine',
       customProps: {
-        icon: '📖',
+        icon: '⚙️',
       },
-      description: 'THEOlive Platform guides',
-      link: { type: 'generated-index', slug: 'platform' },
-      items: [{ type: 'autogenerated', dirName: 'platform' }],
+      description: 'How your stream is processed and packaged for delivery.',
+      link: { type: 'generated-index', slug: 'media-engine' },
+      items: [{ type: 'autogenerated', dirName: 'media-engine' }],
+    },
+    {
+      type: 'category',
+      label: 'Distribution',
+      customProps: {
+        icon: '📤',
+      },
+      description: 'Control how and where your stream reaches viewers.',
+      link: { type: 'generated-index', slug: 'distribution' },
+      items: [{ type: 'autogenerated', dirName: 'distribution' }],
     },
     {
       type: 'category',
       label: 'Playback',
       customProps: {
         icon: '▶️',
       },
-      description: 'THEOlive Playback / Player guides',
-      link: { type: 'generated-index', slug: 'playback' },
+      description: 'Integrate the player into your app or website.',
+      link: { type: 'doc', id: 'playback/optiview-player' },
       items: [{ type: 'autogenerated', dirName: 'playback' }],
     },
+    {
+      type: 'category',
+      label: 'Platform',
+      customProps: {
+        icon: '📖',
+      },
+      description: 'THEOlive Platform guides',
+      link: { type: 'generated-index', slug: 'platform' },
+      items: [{ type: 'autogenerated', dirName: 'platform' }],
+    },
     'troubleshooting',
     {
       type: 'html',
       value: '<hr />',
     },
-    {
-      type: 'doc',
-      id: 'contribution/hardware-encoders/index',
-    },
-    {
-      type: 'doc',
-      id: 'contribution/software-encoders/index',
-    },
     {
       type: 'link',
-      label: 'THEOlive REST API',
+      label: 'REST API',
       customProps: {
         icon: '🛜',
       },
       href: '/theolive/next/api/',
     },
+    'api/migration-from-v1',
   ],
   theoLiveApi: [
     {
@@ -64,6 +89,8 @@ const sidebars: SidebarsConfig = {
       href: '/theolive/next/',
     },
     'api/index',
+    'api/authentication',
+    'api/full-example',
     ...apiSidebar.slice(1),
   ],
 };

sidebarsTheoplayer.ts

@@ -46,14 +46,6 @@ const sidebars: SidebarsConfig = {
             exclude: platformNames,
           },
         },
-        {
-          type: 'category',
-          label: 'THEOlive',
-          customProps: {
-            icon: '🚀',
-          },
-          items: [{ type: 'link', label: 'Getting started', href: '/theolive/playback/web/getting-started/' }],
-        },
         {
           type: 'autogenerated',
           dirName: 'how-to-guides/web',
@@ -92,14 +84,6 @@ const sidebars: SidebarsConfig = {
             exclude: platformNames,
           },
         },
-        {
-          type: 'category',
-          label: 'THEOlive',
-          customProps: {
-            icon: '🚀',
-          },
-          items: [{ type: 'link', label: 'Getting started', href: '/theolive/playback/android/getting-started/' }],
-        },
         {
           type: 'autogenerated',
           dirName: 'how-to-guides/android',
@@ -168,6 +152,10 @@ const sidebars: SidebarsConfig = {
             exclude: platformNames,
           },
         },
+        {
+          type: 'autogenerated',
+          dirName: 'how-to-guides/react-native',
+        },
       ],
     }),
     connectorsCategory({
@@ -189,7 +177,13 @@ const sidebars: SidebarsConfig = {
     'flutter/index',
     'external/flutter-theoplayer-sdk/flutter_theoplayer_sdk/flutter_theoplayer_sdk/README',
     howToGuidesCategory({
-      items: [{ type: 'autogenerated', dirName: 'external/flutter-theoplayer-sdk/doc' }],
+      items: [
+        { type: 'autogenerated', dirName: 'external/flutter-theoplayer-sdk/doc' },
+        {
+          type: 'autogenerated',
+          dirName: 'how-to-guides/flutter',
+        },
+      ],
     }),
     'external/flutter-theoplayer-sdk/flutter_theoplayer_sdk/flutter_theoplayer_sdk/CHANGELOG',
     githubLink({
@@ -239,12 +233,8 @@ const sidebars: SidebarsConfig = {
           },
         },
         {
-          type: 'category',
-          label: 'THEOlive',
-          customProps: {
-            icon: '🚀',
-          },
-          items: [{ type: 'link', label: 'Getting started', href: '/theolive/playback/roku/getting-started/' }],
+          type: 'autogenerated',
+          dirName: 'how-to-guides/roku',
         },
       ],
     }),

theolive/api/authentication.mdx

@@ -0,0 +1,46 @@
+---
+sidebar_label: Authentication
+sidebar_position: 0
+---
+
+# Authentication
+
+
+To make secure calls to the REST API, both authentication and authorization are required. OptiView Live uses token–secret pairs to authorize API requests and ensure secure access.
+
+## Creating an API token
+
+1. Navigate to **API Tokens** in the dashboard.
+2. Click **New** to create a new token.
+3. Enter a name for the token.
+4. Confirm to generate the token.
+
+The key and secret will be displayed once the token is created.
+
+:::warning[Note down your key and secret]
+
+Make sure to store the key and secret securely — they cannot be viewed again after this step.
+
+:::
+
+## Using the token-secret pair with Basic Authentication
+
+OptiView Live uses Basic Authentication for API requests. To authenticate, include your key-secret pair (base64-encoded) in the `Authorization` header, prepended with the word `Basic`.
+
+1. Combine your key and secret in the format `key:secret`.
+   Example: `my-token:my-secret`
+
+2. Base64 encode the combined value.
+   Example: `bXktdG9rZW46bXktc2VjcmV0`
+
+3. Include the encoded string in the Authorization header, prefixed with the word Basic.
+   Example header: `Authorization: Basic bXktdG9rZW46bXktc2VjcmV0`
+
+## Full example
+
+```bash
+curl -X GET https://api.theo.live/v2/channels \
+  -H "Authorization: Basic bXktdG9rZW46bXktc2VjcmV0"
+```
+
+You're now ready to make authenticated requests to the OptiView Live API.