API Reference

curl https://api.mena-stream.com/api/v1/rooms \
  -H "X-API-Key: msk_live_YOUR_KEY" \
  -H "Content-Type: application/json"

const headers = {
  'X-API-Key': 'msk_live_YOUR_KEY',
  'Content-Type': 'application/json',
};

$headers = [
  'X-API-Key: msk_live_YOUR_KEY',
  'Content-Type: application/json',
];

// npm install node-fetch
import fetch from 'node-fetch';

const API_KEY = 'msk_live_YOUR_KEY';
const BASE    = 'https://api.mena-stream.com/api/v1';
const headers = { 'X-API-Key': API_KEY, 'Content-Type': 'application/json' };

// 1. Create room
const room = await fetch(`${BASE}/rooms`, {
  method: 'POST', headers,
  body: JSON.stringify({ name: 'My Meeting', expires_in: 60 }),
}).then(r => r.json());

// 2. Generate join token for user
const join = await fetch(`${BASE}/rooms/${room.id}/join`, {
  method: 'POST', headers,
  body: JSON.stringify({ display_name: 'Ahmed', role: 'moderator' }),
}).then(r => r.json());

// 3. Send token to frontend — it connects via SDK
console.log(join.token);   // JWT token
console.log(join.ws_url);  // wss://api.mena-stream.com/ws/?token=...

// config/services.php
'mena_stream' => [
    'key'  => env('MENA_STREAM_API_KEY'),
    'base' => 'https://api.mena-stream.com/api/v1',
],

// In your controller
use Illuminate\Support\Facades\Http;

class MeetingController extends Controller
{
    public function create()
    {
        $http = Http::withHeaders([
            'X-API-Key' => config('services.mena_stream.key'),
        ])->baseUrl(config('services.mena_stream.base'));

        // Create room
        $room = $http->post('/rooms', [
            'name'       => 'Team Standup',
            'expires_in' => 30,
        ])->json();

        // Generate token for current user
        $join = $http->post("/rooms/{$room['id']}/join", [
            'display_name' => auth()->user()->name,
            'role'         => 'moderator',
        ])->json();

        return view('meeting', [
            'room'  => $room,
            'token' => $join['token'],
            'wsUrl' => $join['ws_url'],
        ]);
    }
}

# pip install requests
import requests

API_KEY = "msk_live_YOUR_KEY"
BASE    = "https://api.mena-stream.com/api/v1"
headers = {"X-API-Key": API_KEY, "Content-Type": "application/json"}

# Create room
room = requests.post(f"{BASE}/rooms",
    headers=headers,
    json={"name": "My Meeting", "expires_in": 60}
).json()

# Join room
join = requests.post(f"{BASE}/rooms/{room['id']}/join",
    headers=headers,
    json={"display_name": "Ahmed", "role": "moderator"}
).json()

print(join["token"])   # Send to frontend

// Install
npm install @mena-stream/client

// Usage
import { MenaStreamClient } from '@mena-stream/client';

const client  = new MenaStreamClient({ wsUrl: join.ws_url });
const session = await client.join({ displayName: 'Ahmed' });

// Enable camera
const stream = await session.enableCamera();
videoElement.srcObject = stream;

// Listen for other participants
session.addEventListener('newProducer', ({ detail }) => {
  // New participant joined
});