Maven v2.0.0

Java SDK

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

mvn install io.github.traffic-orchestrator:traffic-orchestrator-sdk

Quick Start

Initialize the client and start validating licenses.

java

import com.trafficorchestrator.sdk.TrafficOrchestrator;

TrafficOrchestrator client = TrafficOrchestrator.builder()
    .baseUrl("https://api.trafficorchestrator.com/api/v1")
    .build();

License Validation

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

java

// Validate a license key
ValidationResult result = client.validateLicense(
    "TO-XXXX-XXXX-XXXX",
    "example.com"
);

if (result.isValid()) {
    System.out.println("License active!");
}

Offline Verification

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

java

// Verify offline with Ed25519 signature
boolean isValid = client.verifyOffline(
    "TO-XXXX-XXXX-XXXX",
    signature,
    publicKey
);

Management API

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

java

// Authenticated client for management
TrafficOrchestrator admin = TrafficOrchestrator.builder()
    .baseUrl("https://api.trafficorchestrator.com/api/v1")
    .apiKey("your-api-key")
    .build();

List<License> licenses = admin.listLicenses();
License newLicense = admin.createLicense("my-app", "pro");
UsageStats usage = admin.getUsage();
HealthStatus 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

API Reference All SDKs Full Documentation