PHP server SDK

composer require applooma/server-sdk

APPLOOMA_API_KEY=ak_your_key
APPLOOMA_API_SECRET=as_your_secret

<?php
require __DIR__ . '/vendor/autoload.php';

$apiKey    = getenv('APPLOOMA_API_KEY');
$apiSecret = getenv('APPLOOMA_API_SECRET');

if ($apiKey === false || $apiSecret === false) {
    throw new RuntimeException('AppLooma credentials are missing');
}

$applooma = new \AppLooma\AppServerClient($apiKey, $apiSecret);

$applooma = new \AppLooma\AppServerClient($apiKey, $apiSecret, 'https://api.eu.applooma.dev/v1');

<?php
require __DIR__ . '/vendor/autoload.php';

use AppLooma\AppServerClient;
use AppLooma\AppApiException;

header('Content-Type: application/json');

$applooma = new AppServerClient(
    getenv('APPLOOMA_API_KEY'),
    getenv('APPLOOMA_API_SECRET')
);

// 1. Authenticate YOUR user. This endpoint is the gate to your quota.
$user = authenticate();
if (!$user) {
    http_response_code(401);
    exit(json_encode(['error' => 'Sign in first']));
}

$body    = json_decode(file_get_contents('php://input'), true) ?? [];
$channel = (string) ($body['channel'] ?? '');

// 2. Decide the role on the server. Never trust a role from the client.
$role = isHost($user->id, $channel) ? 'host' : 'audience';

try {
    $res = $applooma->createToken([
        'roomName' => $channel,              // [a-zA-Z0-9_-], 1-64 characters
        'identity' => $user->id,             // unique per participant
        'role'     => $role,                 // host | cohost | audience
        'metadata' => ['name' => $user->displayName],
    ]);
} catch (AppApiException $e) {
    error_log("AppLooma {$e->status} {$e->errorCode}: {$e->getMessage()}");

    if ($e->errorCode === 'QUOTA_EXCEEDED') {
        http_response_code(503);
        exit(json_encode(['error' => 'Calling is temporarily unavailable']));
    }
    http_response_code(502);
    exit(json_encode(['error' => 'Could not start the call']));
}

echo json_encode(['token' => $res['token'], 'wsUrl' => $res['wsUrl']]);

public function createToken(array $params): array

public function listRooms(): array

public function listParticipants(string $roomName): array

foreach ($applooma->listRooms() as $room) {
    echo $room['roomName'], ' ', $room['participantCount'], PHP_EOL;

    foreach ($applooma->listParticipants($room['roomName']) as $p) {
        echo '  ', $p['identity'], ' ', $p['joinedAt'], PHP_EOL;
    }
}

namespace AppLooma;

class AppApiException extends \Exception
{
    public int $status;         // HTTP status, or 0 for a transport failure
    public ?string $errorCode;  // machine-readable code, when present
    // getMessage() gives the human-readable message from the API
}

use AppLooma\AppApiException;

try {
    $res = $applooma->createToken([
        'roomName' => 'lobby',
        'identity' => $user->id,
    ]);
} catch (AppApiException $e) {
    if ($e->status === 0) {
        // No HTTP response at all: DNS, TLS or connection failure.
        error_log('AppLooma unreachable: ' . $e->getMessage());
        throw new RuntimeException('Calling is temporarily unavailable');
    }

    switch ($e->errorCode) {
        case 'QUOTA_EXCEEDED':
            // Out of minutes for the month. Alert your team and upgrade.
            throw new RuntimeException('Calling is temporarily unavailable');
        case 'ACCOUNT_SUSPENDED':
            // Billing or policy issue. Only the account owner can resolve it.
            throw new RuntimeException('Calling is temporarily unavailable');
        default:
            if ($e->status === 400) {
                throw new InvalidArgumentException($e->getMessage());
            }
            if ($e->status === 401) {
                throw new RuntimeException('AppLooma credentials are wrong');
            }
            throw $e;
    }
}

<?php

function applooma_request(string $method, string $path, ?array $body = null): array
{
    $ch = curl_init('https://api.applooma.dev/v1' . $path);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST  => $method,
        CURLOPT_TIMEOUT        => 15,
        CURLOPT_HTTPHEADER     => [
            'Content-Type: application/json',
            'x-applooma-key: ' . getenv('APPLOOMA_API_KEY'),
            'x-applooma-secret: ' . getenv('APPLOOMA_API_SECRET'),
        ],
    ]);
    if ($body !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
    }

    $raw = curl_exec($ch);
    if ($raw === false) {
        $err = curl_error($ch);
        curl_close($ch);
        throw new RuntimeException('AppLooma request failed: ' . $err);
    }
    $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    curl_close($ch);

    $data = json_decode($raw, true) ?? [];
    if ($status >= 400) {
        throw new RuntimeException(
            sprintf('%d %s: %s', $status, $data['code'] ?? '', $data['error'] ?? 'unknown')
        );
    }
    return $data;
}

// Gift catalogue
$gifts = applooma_request('GET', '/gifts')['gifts'];

// Send a gift. Debit the sender in YOUR coin system first.
$tx = applooma_request('POST', '/gifts/send', [
    'roomName' => 'lobby',
    'giftId'   => $gifts[0]['id'],
    'sender'   => 'user-42',
    'receiver' => 'host-7',
    'quantity' => 1,
]);
// $tx = ['txId' => ..., 'coinTotal' => ..., 'sentAt' => ...]

// RTMP ingest for OBS
$ingest = applooma_request('POST', '/streams/ingest', [
    'roomName' => 'lobby',
    'name'     => 'obs-ingest',
    'type'     => 'rtmp',
]);
// $ingest = ['ingestId' => ..., 'url' => ..., 'streamKey' => ..., 'status' => 'ready']