Go v2.0.0
Go SDK
Official Go SDK for Traffic Orchestrator. Validate licenses, manage keys, and integrate license management into your application in minutes.
go get github.com/traffic-orchestrator/go-sdk
Quick Start
Initialize the client and start validating licenses.
go
import to "traffic-orchestrator/go-sdk"
client := to.NewClient("https://api.trafficorchestrator.com/api/v1")License Validation
Validate a license key against a domain with a single call.
go
// Validate a license key
result, err := client.ValidateLicense(
"TO-XXXX-XXXX-XXXX",
"example.com",
)
if err != nil { log.Fatal(err) }
if result.Valid {
fmt.Println("License active!")
}Offline Verification
Verify licenses offline using Ed25519 cryptographic signatures — no network required.
go
// Verify offline with Ed25519 signature
isValid, err := client.VerifyOffline(
"TO-XXXX-XXXX-XXXX",
signature,
publicKey,
)Management API
Create licenses, list existing keys, and monitor usage with authenticated API calls.
go
// Authenticated client for management
admin := to.NewAuthenticatedClient(
"https://api.trafficorchestrator.com/api/v1",
"your-api-key",
)
licenses, _ := admin.ListLicenses()
newLicense, _ := admin.CreateLicense(to.LicenseParams{
Product: "my-app",
Plan: "pro",
})
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