Exbil Reselling API Client

PHP API Client for the Exbil Reselling Portal.

Installation

composer require exbil/reselling-api-client

Quick Start

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

use Exbil\ResellingAPI\Client;

$client = new Client('your-api-key', 'https://reselling-portal.de/api/');

// List servers
$servers = $client->rootServer()->getAll();

// Create VPN account
$account = $client->vpn()->account()->create('username', 'password');

// Register a domain
$domain = $client->domain()->register('example.com', [
    'owner_handle' => 1,
    'admin_handle' => 1,
    'tech_handle' => 1,
]);

// Create Mailcow domain
$mailcowDomain = $client->mailcow()->create('node-1', [
    'domain' => 'example.com',
    'mailboxes' => 10,
    'aliases' => 50,
    'quota_mb' => 5000,
]);

Authentication

All API requests require an API key transmitted as Bearer Token:

$client = new Client('your-api-key');

For the sandbox environment use the sandbox base URL:

$client = new Client('rs_sb_…', 'https://www.reselling-portal.de/api/sandbox/');

You can verify the configured key and inspect its scoped permissions at any time:

$info = $client->validateKey();
// → ['key' => [...], 'permissions' => [...], 'rate_limit' => [...]]

API Reference

Accounting

Billing, invoices, credit and usage.

Method	Description
`getUserData()`	Team/user billing information
`getCreditStatus()`	Current credit status
`getUsage()`	Current month usage summary
`getUsageDetails(array $filters)`	Detailed usage records
`getInvoices()`	All invoices
`getInvoice(int $id)`	Single invoice

// Get credit status
$credit = $client->accounting()->getCreditStatus();

// Get usage with filters
$usage = $client->accounting()->getUsageDetails([
    'start' => '2024-01-01',
    'end' => '2024-01-31',
    'product_type' => 'rootserver',
    'limit' => 100,
]);

// Get invoice
$invoice = $client->accounting()->getInvoice(123);

Domain

Domain registration, transfer, DNS management and handles.

Main Methods

Method	Description
`getAll()`	All domains
`get(string $domain)`	Single domain
`checkAvailability(string $domain)`	Check availability
`checkBulkAvailability(array $domains)`	Bulk availability check (max 50)
`register(string $domain, array $handles, array $nameservers, int $period)`	Register domain
`transfer(string $domain, string $authcode, array $handles, array $nameservers)`	Transfer domain
`sync(string $domain)`	Sync from registrar
`getAuthcode(string $domain)`	Get authcode
`updateHandles(string $domain, array $handles)`	Update handles
`requestDeletion(string $domain)`	Request deletion
`cancelDeletion(string $domain)`	Cancel deletion

// Check availability
$check = $client->domain()->checkAvailability('example.com');

// Bulk availability check (up to 50 domains per request)
$bulk = $client->domain()->checkBulkAvailability([
    'example.com',
    'example.de',
    'example.net',
]);

// Register domain
$domain = $client->domain()->register('example.com', [
    'owner_handle' => 1,
    'admin_handle' => 1,
    'tech_handle' => 1,
], ['ns1.example.net', 'ns2.example.net'], 1);

// Transfer domain
$transfer = $client->domain()->transfer('example.com', 'AUTH-CODE-123', [
    'owner_handle' => 1,
    'admin_handle' => 1,
    'tech_handle' => 1,
]);

Pricing (`$client->domain()->pricing()`)

Method	Description
`getAll()`	All domain prices
`getTlds()`	Available TLDs
`getByTld(string $tld)`	Pricing for specific TLD

$prices = $client->domain()->pricing()->getAll();
$tlds = $client->domain()->pricing()->getTlds();
$comPrice = $client->domain()->pricing()->getByTld('com');

Handle (`$client->domain()->handle()`)

Method	Description
`getTypes()`	Available handle types
`getAll()`	All handles
`get(string\|int $id)`	Single handle
`create(array $data)`	Create handle
`update(string\|int $id, array $data)`	Update handle
`delete(string\|int $id)`	Delete handle
`setDefault(string\|int $id)`	Set as default

// Create handle
$handle = $client->domain()->handle()->create([
    'type' => 'person',
    'firstname' => 'John',
    'lastname' => 'Doe',
    'street' => '123 Main St',
    'city' => 'Berlin',
    'zip' => '10115',
    'country' => 'DE',
    'phone' => '+49.301234567',
    'email' => 'john@example.com',
]);

// Set as default
$client->domain()->handle()->setDefault(1);

Nameserver (`$client->domain()->nameserver()`)

Method	Description
`get(string $domain)`	Get nameservers
`update(string $domain, array $nameservers)`	Update nameservers

$ns = $client->domain()->nameserver()->get('example.com');
$client->domain()->nameserver()->update('example.com', [
    'ns1.example.net',
    'ns2.example.net',
]);

DNS (`$client->domain()->dns()`)

Method	Description
`get(string $domain)`	Get DNS records
`create(string $domain, array $record)`	Create record
`update(string $domain, string\|int $recordId, array $data)`	Update record
`bulkUpdate(string $domain, array $records)`	Bulk update records
`delete(string $domain, string\|int $recordId)`	Delete record
`getZones(string $domain)`	Get DNS zones
`createZone(string $domain, array $zone)`	Create zone
`updateZone(string $domain, string\|int $zoneId, array $data)`	Update zone
`deleteZone(string $domain, string\|int $zoneId)`	Delete zone

// Get DNS records
$records = $client->domain()->dns()->get('example.com');

// Create A record
$record = $client->domain()->dns()->create('example.com', [
    'type' => 'A',
    'name' => '@',
    'content' => '192.168.1.1',
    'ttl' => 3600,
]);

// Create MX record
$client->domain()->dns()->create('example.com', [
    'type' => 'MX',
    'name' => '@',
    'content' => 'mail.example.com',
    'priority' => 10,
]);

// Bulk update
$client->domain()->dns()->bulkUpdate('example.com', [
    ['type' => 'A', 'name' => '@', 'content' => '192.168.1.1'],
    ['type' => 'AAAA', 'name' => '@', 'content' => '2001:db8::1'],
]);

Root Server

Manage virtual servers.

Main Methods

Method	Description
`getAll(array $filters)`	All servers (filters: state, datacenter_id, cluster_id)
`get(int $vmId)`	Single server
`create(string $clusterSlug, array $config)`	Create server
`update(int $vmId, array $config)`	Resize server
`delete(int $vmId)`	Delete server
`resetRootPassword(int $vmId, ?string $password)`	Reset root password
`reinstall(int $vmId, array $config)`	Reinstall server
`getStats(int $vmId)`	Live statistics (CPU, RAM, network)
`getLogs(int $vmId, int $limit)`	Server logs
`getTasks(int $vmId, int $limit)`	Running/completed tasks

// Create server
$server = $client->rootServer()->create('cluster-de-1', [
    'hostname' => 'web-server-01',
    'cores' => 4,
    'ram_mb' => 8192,
    'disk_gb' => 100,
    'operating_system_slug' => 'ubuntu-22.04',
    'root_password' => 'secure-password',
    'ipv4_addresses' => 1,
    'backup_slots' => 1,
]);

// Resize server (disk can only be increased)
$client->rootServer()->update(12345, [
    'cores' => 8,
    'ram_mb' => 16384,
]);

// Get stats
$stats = $client->rootServer()->getStats(12345);

Location (`$client->rootServer()->location()`)

Method	Description
`getAll()`	All datacenters
`getClusters(string $datacenterSlug)`	Clusters of a datacenter

$locations = $client->rootServer()->location()->getAll();
$clusters = $client->rootServer()->location()->getClusters('de-fra');

Cluster (`$client->rootServer()->cluster()`)

Method	Description
`getAll()`	All clusters
`get(string $clusterSlug)`	Single cluster
`getOsList(string $clusterSlug)`	Available operating systems
`getPrices(string $clusterSlug)`	Price list of a cluster
`calculatePrice(string $clusterSlug, array $config)`	Calculate price

// Get OS list for cluster
$osList = $client->rootServer()->cluster()->getOsList('cluster-de-1');

// Calculate price
$price = $client->rootServer()->cluster()->calculatePrice('cluster-de-1', [
    'cores' => 4,
    'ram_mb' => 8192,
    'disk_gb' => 100,
    'backup_slots' => 1,
    'ipv4_addresses' => 1,
    'ipv6_addresses' => 1,
]);

Power (`$client->rootServer()->power()`)

Method	Description
`start(int $vmId)`	Start server
`stop(int $vmId)`	Shutdown server (graceful)
`reboot(int $vmId)`	Reboot server
`forceStop(int $vmId)`	Power off server (force)

$client->rootServer()->power()->start(12345);
$client->rootServer()->power()->stop(12345);
$client->rootServer()->power()->reboot(12345);
$client->rootServer()->power()->forceStop(12345);

VPN

VPN accounts and configurations.

Main Methods

Method	Description
`getServers()`	All VPN servers
`getPorts()`	Available ports
`getPricing()`	Pricing
`getGeoIP()`	GeoIP info of current request
`checkUsername(string $username)`	Check username availability

$servers = $client->vpn()->getServers();
$pricing = $client->vpn()->getPricing();
$available = $client->vpn()->checkUsername('new-user');

Account (`$client->vpn()->account()`)

Method	Description
`getAll()`	All VPN accounts
`get(int $id)`	Single account
`create(string $username, ?string $password)`	Create account
`delete(int $id)`	Delete account
`sync(int $id)`	Sync account
`changePassword(int $id, string $password)`	Change password
`enable(int $id)`	Enable account
`disable(int $id)`	Disable account

// Create account
$account = $client->vpn()->account()->create('new-user', 'secure-password');

// Change password
$client->vpn()->account()->changePassword(123, 'new-password');

// Sync account
$client->vpn()->account()->sync(123);

// Enable account (must be disabled, pending, or error state)
$client->vpn()->account()->enable(123);

// Disable account (must be active state)
$client->vpn()->account()->disable(123);

Note: Suspended accounts cannot be enabled via API. Contact support to lift the suspension.

Config (`$client->vpn()->config()`)

Method	Description
`getOpenVpn(int $accountId, int $serverId, int $portId)`	OpenVPN config (JSON)
`downloadOpenVpn(int $accountId, int $serverId, int $portId)`	OpenVPN .ovpn download
`getWireGuard(int $accountId, int $serverId)`	WireGuard config (JSON)
`downloadWireGuard(int $accountId, int $serverId)`	WireGuard .conf download

// OpenVPN configuration
$ovpnConfig = $client->vpn()->config()->getOpenVpn(123, 1, 443);

// WireGuard configuration
$wgConfig = $client->vpn()->config()->getWireGuard(123, 1);

Mailcow

Email domains, mailboxes and aliases.

Main Methods

Method	Description
`getNodes(?string $datacenter)`	All Mailcow nodes
`getLoadBalancerStats(?string $datacenter)`	Load balancer statistics
`calculatePrice(string $nodeOrDc, int $mailboxes, int $aliases, int $quotaMb)`	Calculate price
`getAll(?string $id)`	All or single domain
`get(string\|int $id)`	Single domain
`create(string $nodeOrDc, array $config)`	Create domain
`update(string\|int $id, array $config)`	Update domain
`delete(string\|int $id)`	Delete domain

// Get nodes
$nodes = $client->mailcow()->getNodes();

// Create domain
$domain = $client->mailcow()->create('node-1', [
    'domain' => 'example.com',
    'mailboxes' => 10,
    'aliases' => 50,
    'quota_mb' => 5000,
    'defquota_mb' => 500,
    'maxquota_mb' => 1000,
    'admin_username' => 'admin',
    'admin_password' => 'secure-password',
]);

// Update domain
$client->mailcow()->update('example.com', [
    'mailboxes' => 20,
    'quota_mb' => 10000,
]);

Mailbox (`$client->mailcow()->mailbox()`)

Method	Description
`getAll(string $domain, ?int $id)`	Get mailboxes
`get(string $domain, int $mailboxId)`	Single mailbox
`create(string $domain, string $address, array $config)`	Create mailbox
`update(string $domain, string $address, array $config)`	Update mailbox
`delete(string $domain, string $localPart)`	Delete mailbox

// Create mailbox
$mailbox = $client->mailcow()->mailbox()->create('example.com', 'info', [
    'password' => 'secure-password',
    'name' => 'Info Mailbox',
    'quota_mb' => 500,
]);

// Update mailbox
$client->mailcow()->mailbox()->update('example.com', 'info', [
    'quota_mb' => 1000,
    'active' => true,
]);

// Delete mailbox
$client->mailcow()->mailbox()->delete('example.com', 'info');

Alias (`$client->mailcow()->alias()`)

Method	Description
`getAll(string $domain, ?int $id)`	Get aliases
`get(string $domain, int $aliasId)`	Single alias
`create(string $domain, string $address, array $goto)`	Create alias
`update(string $domain, string $address, array $goto, ?bool $active)`	Update alias
`delete(string $domain, string $localPart)`	Delete alias

// Create alias
$alias = $client->mailcow()->alias()->create('example.com', 'support', [
    'info@example.com',
    'admin@example.com',
]);

// Update alias
$client->mailcow()->alias()->update('example.com', 'support', [
    'info@example.com',
], true);

// Delete alias
$client->mailcow()->alias()->delete('example.com', 'support');

Domain Admin (`$client->mailcow()->domainAdmin()`)

Method	Description
`getAll(string $domain, ?int $id)`	Get domain admins
`get(string $domain, int $adminId)`	Single admin
`create(string $domain, string $username, ?string $password)`	Create admin
`update(string $domain, string $username, array $config)`	Update admin
`delete(string $domain, string $username)`	Delete admin

// Create admin
$admin = $client->mailcow()->domainAdmin()->create('example.com', 'admin', 'secure-password');

// Update admin
$client->mailcow()->domainAdmin()->update('example.com', 'admin', [
    'password' => 'new-password',
    'active' => true,
]);

Cloud Services

Container based services — game servers (Minecraft, TeamSpeak, CS2, Rust, Palworld, …), databases (MySQL, MariaDB, PostgreSQL, MongoDB, Redis, …), web stacks (Caddy, Apache+PHP, Node.js, Python, Bun, …), discord bots, and ~250 other templates. Services and backups are addressed by their UUID.

Main Methods

Method	Description
`templates()`	Order catalogue — every active template + node bindings + field_schema
`getAll(array $filters = [])`	All cloud services (filters: status, per_page, team_id)
`get(string $uuid)`	Service details incl. live status
`create(array $config)`	Create a service (node_id, template_slug, name, memory_limit, disk_limit, cpu_limit, …)
`delete(string $uuid)`	Delete a service
`reinstall(string $uuid, array $options = [])`	Reinstall a service — see options below
`status(string $uuid)`	Live resource usage / status
`sendCommand(string $uuid, string $command)`	Send a console command (one-shot REST)
`consoleToken(string $uuid)`	Issue a scoped token + wss:// URLs for the live console + stats streams
`allocations(string $uuid)`	List every port allocation with role + protocol + description

// === ORDER FLOW ============================================

// 1) Pull the order catalogue
$catalog = $client->cloudServices()->templates();
$mcPaper = collect($catalog['data']['templates'])
    ->firstWhere('slug', 'minecraft-paper');
$node    = $catalog['data']['nodes'][0];

// 2) Place the order
$service = $client->cloudServices()->create([
    'node_id'       => $node['id'],
    'template_slug' => $mcPaper['slug'],
    'name'          => 'My Survival World',
    'memory_limit'  => 4096,                    // MB
    'disk_limit'    => 10240,                   // MB
    'cpu_limit'     => 200,                     // % of one core
    'environment'   => [                        // override env defaults
        'MC_VERSION'    => '1.21.11',
        'RCON_ENABLED'  => 'true',
        'RCON_PASSWORD' => bin2hex(random_bytes(8)),
    ],
]);

// 3) Watch the install land
$uuid = $service['data']['uuid'];
while (true) {
    $s = $client->cloudServices()->get($uuid)['data'];
    if (in_array($s['status'], ['running', 'install_failed', 'offline'])) break;
    sleep(3);
}

// === MANAGEMENT ============================================

$services = $client->cloudServices()->getAll(['status' => 'running']);
$service  = $client->cloudServices()->get('a1b2c3d4-...');
$client->cloudServices()->sendCommand('a1b2c3d4-...', 'say hello');
$client->cloudServices()->allocations('a1b2c3d4-...');

reinstall($uuid, $options) options array

Key	Type	Description
`auto_start`	`bool`	When `true`, the daemon starts the server the moment the wipe + image pull finishes — the customer sees the entrypoint's seed phase (Downloading vanilla jar..., npm run setup, ...) in the live console without a second click. Recommended for customer-facing flows.
`cloudservice`	`string`	Switch to a different service template at the same time (template-switch reinstall).
`environment`	`array`	Override environment variables for the (possibly new) template.

$client->cloudServices()->reinstall('a1b2c3d4-...', ['auto_start' => true]);

consoleToken($uuid) — Live WebSocket console + stats

Use this instead of polling REST sendCommand() when you need a live console view or want to stream output back to a client. The daemon accepts a short-lived (5 min) scoped token via Sec-WebSocket-Protocol, so the token never lands in URLs / proxy logs / browser history.

$ws = $client->cloudServices()->consoleToken('a1b2c3d4-...');
// $ws = [
//   'token'               => 'cst_...',
//   'subprotocols'        => ['cst', 'cst_...'],
//   'websocket_url'       => 'wss://node01.example.com:443/api/v1/servers/<uuid>/console',
//   'stats_websocket_url' => 'wss://node01.example.com:443/api/v1/servers/<uuid>/stats',
//   'expires_in_sec'      => 300,
// ]

Browser-side (vanilla JS):

const ws = new WebSocket(data.websocket_url, data.subprotocols);
ws.onmessage = e => console.log(e.data);
ws.send(JSON.stringify({event: 'command', command: 'list'}));

Token TTL is ~5 min; re-call consoleToken() before expiry to keep a long-running session alive. The same token authenticates BOTH the console and the stats WebSocket — connect to whichever URL you need.

Power (`$client->cloudServices()->power()`)

Method	Description
`start(string $uuid)`	Start service
`stop(string $uuid)`	Stop service (graceful)
`restart(string $uuid)`	Restart service
`kill(string $uuid)`	Kill service (force stop)

$client->cloudServices()->power()->start('a1b2c3d4-...');
$client->cloudServices()->power()->restart('a1b2c3d4-...');

Files (`$client->cloudServices()->files()`)

Method	Description
`list(string $uuid, string $dir = '/')`	List a directory
`read(string $uuid, string $file)`	Read file contents
`write(string $uuid, string $file, string $content)`	Write a file
`upload(string $uuid, string $filePath, string $dir = '/')`	Upload a local file
`download(string $uuid, string $file)`	Get a download URL
`delete(string $uuid, array $files)`	Delete files
`compress(string $uuid, array $files, string $output)`	Compress into an archive
`decompress(string $uuid, string $file, string $target)`	Extract an archive

$client->cloudServices()->files()->list('a1b2c3d4-...', '/');
$client->cloudServices()->files()->write('a1b2c3d4-...', 'server.properties', "max-players=20\n");

Backups (`$client->cloudServices()->backups()`)

Each service has a slot quota (default 3) and a size cap (default 100 GB). Archives are encrypted at rest with AES-256-GCM and tagged with the team that created or uploaded them — restores across team boundaries are refused with 403 unless the caller passes force => true.

Method	Description
`getAll(string $uuid)`	All backups for a service (with `team_id`, `cloudservice_id`, `origin`, `is_locked`)
`create(string $uuid, ?string $name = null, array $ignoredFiles = [])`	Create a backup of the current volume
`upload(string $uuid, string $filePath)`	Upload a `.tar.gz` archive previously downloaded from this platform
`delete(string $uuid, string $backupId)`	Delete a backup (sends a deletion-certificate mail to the owner)
`restore(string $uuid, string $backupId, array $options = [])`	Restore a backup — stop, extract, chown, auto-start
`toggleLock(string $uuid, string $backupId)`	Toggle the lock flag (locked backups skip retention sweeps)
`download(string $uuid, string $backupId, string $targetPath)`	Stream the encrypted archive to a local path

// Snapshot
$client->cloudServices()->backups()->create('a1b2c3d4-...', 'pre-update');

// Download locally (encrypted .tar.gz — keep as-is for re-upload)
$client->cloudServices()->backups()->download(
    'a1b2c3d4-...',
    'backup-uuid-here',
    '/tmp/my-backup.tar.gz',
);

// Re-upload a backup you saved earlier
$client->cloudServices()->backups()->upload(
    'a1b2c3d4-...',
    '/tmp/my-backup.tar.gz',
);

// Restore. switch_template defaults to true — when the archive was
// taken on a different template (TS3 backup on a TS6 server) the
// daemon flips the server's cloudservice_id + docker_image to match
// the backup before extracting. Pass force=true for operator
// recovery (skips both the cross-team and cross-template guards).
$client->cloudServices()->backups()->restore(
    'a1b2c3d4-...',
    'backup-uuid-here',
    ['switch_template' => true],
);

// Lock an archive against the retention sweep
$client->cloudServices()->backups()->toggleLock('a1b2c3d4-...', 'backup-uuid-here');

Network (`$client->cloudServices()->network()`)

Per-server IPv6 lifecycle. Up to four addresses out of the operator's routed prefix.

Method	Description
`status(string $uuid)`	Node prefix + upstream healthcheck snapshot
`listIpv6(string $uuid)`	Addresses bound to the server (primary first)
`orderIpv6(string $uuid)`	Allocate one more (HTTP 503 if transit down)
`releaseIpv6(string $uuid, int $addressId)`	Release one by daemon-side id

$status = $client->cloudServices()->network()->status('a1b2c3d4-...');
if ($status['enabled'] && ($status['healthcheck']['healthy'] ?? false)) {
    $addr = $client->cloudServices()->network()->orderIpv6('a1b2c3d4-...');
    echo $addr['data']['ipv6'];     // e.g. 2a0e:97c0:440:105::abcd
}

A 503 response carries a detail.last_checked_at + detail.last_error explaining why the upstream is down; surface that to the operator rather than retrying blindly.

Container Registries (`$client->cloudServices()->registries()`)

Customer-owned private Docker registries hosted on the same nodes. Each registry gets a <namespace>.<node-domain> URL and a generated admin password the customer uses to docker login + push images. Packaged (fixed slug → quotas) or custom (storage / repo / robot sliders).

Method	Description
`getAll()`	Calling team's registries
`get(string $uuid)`	Registry details + admin creds (MANAGE-only)
`create(array $config)`	Order a new registry (package or custom mode)
`delete(string $uuid)`	Tear down — secure-wipes blobs before releasing the slot
`packages()`	Catalogue of available packages with prices
`calculatePrice(array $payload)`	Live price preview for the order form
`checkNamespace(string $namespace)`	Returns `{available: bool}` for the typed namespace

// === ORDER FLOW ============================================

// 1) Show catalogue
$packages = $client->cloudServices()->registries()->packages();

// 2) Price-preview
$preview = $client->cloudServices()->registries()->calculatePrice([
    'mode'         => 'package',
    'package_slug' => 'small',
]);

// 3) Reserve the namespace (live as customer types)
$check = $client->cloudServices()->registries()->checkNamespace('myco-prod');
if (!$check['data']['available']) {
    throw new RuntimeException('Namespace taken');
}

// 4) Order
$registry = $client->cloudServices()->registries()->create([
    'mode'         => 'package',
    'package_slug' => 'small',
    'namespace'    => 'myco-prod',
    'auto_upgrade' => true,
]);

// 5) Customer pushes images
//    docker login myco-prod.registry.example.com -u admin -p <admin_password>
//    docker push myco-prod.registry.example.com/myapp:v1.0

packages() returns slug, included storage / repos / robots, hourly cents and a marketing blurb so the order form can render the cards without separate copy decks. Custom mode bypasses the package step:

$client->cloudServices()->registries()->create([
    'mode'        => 'custom',
    'storage_gb'  => 50,
    'repo_limit'  => 20,
    'robot_limit' => 10,
    'namespace'   => 'myco-staging',
]);

TeamSpeak

Order and manage TeamSpeak servers — power, slots, settings, channels, connected clients, privilege tokens, bans and snapshot backups.

// Pricing + available locations (datacenters with free capacity)
$pricing = $client->teamSpeak()->getPricing();

// Order a server (optionally in a specific datacenter)
$server = $client->teamSpeak()->order('My Server', 64);
$server = $client->teamSpeak()->order('My Server', 64, datacenterId: 2);

// List / show / delete
$servers = $client->teamSpeak()->getAll();
$server  = $client->teamSpeak()->get(1);
$client->teamSpeak()->delete(1);

// Live view (info + channels + connected clients) and advanced data
$view   = $client->teamSpeak()->view(1);
$extras = $client->teamSpeak()->extras(1); // groups, tokens, bans, complaints, log

// Power
$client->teamSpeak()->start(1);
$client->teamSpeak()->stop(1);

// Settings
$client->teamSpeak()->resize(1, 128); // subject to the host's free capacity
$client->teamSpeak()->updateSettings(1, ['name' => 'New name', 'password' => 'secret']);
$client->teamSpeak()->broadcast(1, 'Maintenance in 5 minutes');

Channels (`$client->teamSpeak()->channels()`)

$client->teamSpeak()->channels()->create(1, 'Lobby');
$client->teamSpeak()->channels()->create(1, 'Team A', parentId: 5); // sub-channel
$client->teamSpeak()->channels()->delete(1, 5);

Clients (`$client->teamSpeak()->clients()`)

$client->teamSpeak()->clients()->details(1, 12);
$client->teamSpeak()->clients()->move(1, 12, 5);
$client->teamSpeak()->clients()->kick(1, 12, 'Be nice');
$client->teamSpeak()->clients()->ban(1, 12, seconds: 3600, reason: 'Spam');

Security (`$client->teamSpeak()->security()`)

$client->teamSpeak()->security()->createToken(1, serverGroupId: 6, description: 'Admin invite');
$client->teamSpeak()->security()->deleteToken(1, 'the-token-string');
$client->teamSpeak()->security()->addBan(1, ['ip' => '1.2.3.4', 'reason' => 'abuse']);
$client->teamSpeak()->security()->removeBan(1, 42);

Backups (`$client->teamSpeak()->backups()`)

// Download a base64 snapshot (returned under data.snapshot)
$snapshot = $client->teamSpeak()->backups()->download(1)['data']['snapshot'];

// Restore from a snapshot (overwrites channels, groups and permissions)
$client->teamSpeak()->backups()->restore(1, $snapshot);

Error Handling

use Exbil\ResellingAPI\Exceptions\ApiException;
use Exbil\ResellingAPI\Exceptions\AuthenticationException;
use Exbil\ResellingAPI\Exceptions\ForbiddenException;
use Exbil\ResellingAPI\Exceptions\NotFoundException;
use Exbil\ResellingAPI\Exceptions\ValidationException;

try {
    $server = $client->rootServer()->get(99999);
} catch (AuthenticationException $e) {
    // 401 - Invalid API key
    echo "Authentication failed: " . $e->getMessage();
} catch (ForbiddenException $e) {
    // 403 - No permission
    echo "Access denied: " . $e->getMessage();
} catch (NotFoundException $e) {
    // 404 - Resource not found
    echo "Not found: " . $e->getMessage();
} catch (ValidationException $e) {
    // 422 - Validation error
    echo "Validation error: " . $e->getMessage();
    print_r($e->getValidationErrors());
} catch (ApiException $e) {
    // Other API errors
    echo "API error: " . $e->getMessage();
    echo "Status code: " . $e->getCode();
}

Asynchronous Operations

Many operations are executed asynchronously and return a 202 status:

Server create/delete/resize
Power operations (start, stop, reboot)
Mailcow domain/mailbox/alias create/update/delete
VPN account create/delete/enable/disable

The response typically contains a job ID or task information for tracking.

License

BSD-2-Clause

Name		Name	Last commit message	Last commit date
Latest commit History 28 Commits
.github/workflows		.github/workflows
src		src
.gitattributes		.gitattributes
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
composer.json		composer.json

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

Exbil Reselling API Client

Installation

Quick Start

Authentication

API Reference

Accounting

Domain

Main Methods

Pricing ($client->domain()->pricing())

Handle ($client->domain()->handle())

Nameserver ($client->domain()->nameserver())

DNS ($client->domain()->dns())

Root Server

Main Methods

Location ($client->rootServer()->location())

Cluster ($client->rootServer()->cluster())

Power ($client->rootServer()->power())

VPN

Main Methods

Account ($client->vpn()->account())

Config ($client->vpn()->config())

Mailcow

Main Methods

Mailbox ($client->mailcow()->mailbox())

Alias ($client->mailcow()->alias())

Domain Admin ($client->mailcow()->domainAdmin())

Cloud Services

Main Methods

Power ($client->cloudServices()->power())

Files ($client->cloudServices()->files())

Backups ($client->cloudServices()->backups())

Network ($client->cloudServices()->network())

Container Registries ($client->cloudServices()->registries())

TeamSpeak

Channels ($client->teamSpeak()->channels())

Clients ($client->teamSpeak()->clients())

Security ($client->teamSpeak()->security())

Backups ($client->teamSpeak()->backups())

Error Handling

Asynchronous Operations

License

About

Topics

Resources

License

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Pricing (`$client->domain()->pricing()`)

Handle (`$client->domain()->handle()`)

Nameserver (`$client->domain()->nameserver()`)

DNS (`$client->domain()->dns()`)

Location (`$client->rootServer()->location()`)

Cluster (`$client->rootServer()->cluster()`)

Power (`$client->rootServer()->power()`)

Account (`$client->vpn()->account()`)

Config (`$client->vpn()->config()`)

Mailbox (`$client->mailcow()->mailbox()`)

Alias (`$client->mailcow()->alias()`)

Domain Admin (`$client->mailcow()->domainAdmin()`)

Power (`$client->cloudServices()->power()`)

Files (`$client->cloudServices()->files()`)

Backups (`$client->cloudServices()->backups()`)

Network (`$client->cloudServices()->network()`)

Container Registries (`$client->cloudServices()->registries()`)

Channels (`$client->teamSpeak()->channels()`)

Clients (`$client->teamSpeak()->clients()`)

Security (`$client->teamSpeak()->security()`)

Backups (`$client->teamSpeak()->backups()`)

Packages