RubyGems v2.0.0

Ruby SDK

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

gem install traffic_orchestrator

Quick Start

Initialize the client and start validating licenses.

ruby

require 'traffic_orchestrator'

client = TrafficOrchestrator::Client.new(
  'https://api.trafficorchestrator.com/api/v1'
)

License Validation

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

ruby

# Validate a license key
result = client.validate_license(
  'TO-XXXX-XXXX-XXXX',
  'example.com'
)

if result['valid']
  puts "License active!"
end

Offline Verification

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

ruby

# Verify offline with Ed25519 signature
is_valid = client.verify_offline(
  'TO-XXXX-XXXX-XXXX',
  signature,
  public_key
)

Management API

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

ruby

# Authenticated client for management
admin = TrafficOrchestrator::Client.new(
  'https://api.trafficorchestrator.com/api/v1',
  api_key: 'your-api-key'
)

licenses = admin.list_licenses
new_license = admin.create_license(product: 'my-app', plan: 'pro')
usage = admin.get_usage
health = admin.health_check

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