Packagist v2.0.0

PHP SDK

Official PHP SDK for Traffic Orchestrator. Validate licenses, manage keys, and integrate license management into your application in minutes.

composer require traffic-orchestrator/sdk

Quick Start

Initialize the client and start validating licenses.

php
use TrafficOrchestrator\Client;

$client = new Client([
    'base_url' => 'https://api.trafficorchestrator.com/api/v1'
]);

License Validation

Validate a license key against a domain with a single call.

php
// Validate a license key
$result = $client->validateLicense(
    'TO-XXXX-XXXX-XXXX',
    'example.com'
);

if ($result->valid) {
    echo "License active!";
}

Offline Verification

Verify licenses offline using Ed25519 cryptographic signatures — no network required.

php
// Verify offline with Ed25519 signature
$isValid = $client->verifyOffline(
    'TO-XXXX-XXXX-XXXX',
    $signature,
    $publicKey
);

Management API

Create licenses, list existing keys, and monitor usage with authenticated API calls.

php
// Authenticated client for management
$admin = new Client([
    'base_url' => 'https://api.trafficorchestrator.com/api/v1',
    'api_key' => 'your-api-key'
]);

$licenses = $admin->listLicenses();
$newLicense = $admin->createLicense(['product' => 'my-app']);
$usage = $admin->getUsage();
$health = $admin->healthCheck();

Available Methods

validateLicense()
Validate a license key against a domain
verifyOffline()
Cryptographic offline verification (Ed25519)
listLicenses()
List all licenses (requires API key)
createLicense()
Create a new license key (requires API key)
getUsage()
Retrieve usage statistics (requires API key)
healthCheck()
Check API health and connectivity
gracePeriod
Cache validation results for resilience during API outages (v2.1.0+)
clearCache()
Clear cached validation results immediately