Download the PHP package tobischulz/laravel-respawnhost-sdk without Composer

Laravel RespawnHost SDK

Laravel package to integrate with the official RespawnHost API and manage game servers from your application.

Current scope

This repository now contains a stable SDK foundation:

• centralized HTTP client with Bearer API key authentication
• configurable base URL, timeouts, retries, and user agent
• first resource clients for:
  • servers
  • payments
  • transactions
  • catalog (public games + packages)
• dedicated exception type for failed API responses
• test baseline with Pest + Testbench

The current implementation was prepared against the public RespawnHost OpenAPI document (version: 1.0.0) and product context from respawnhost.com on February 13, 2026.

Installation

Publish the configuration:

Configuration

Set these environment variables:

Default config file (config/respawnhost-sdk.php):

API Token (Dev and Production)

As of February 13, 2026, the public RespawnHost docs state that API keys are created in the account dashboard:

• Authentication
• FAQ

Directlink to api-key-management Dashboard:

• https://respawnhost.com/de/api-keys

This route currently redirects unauthenticated users to login and is not explicitly documented in the public developer docs, so it may change.

Token for dev environment

1. Log in to your RespawnHost dashboard.
2. Open API key management from dashboard settings (or use the direct URL above).
3. Create a dedicated dev key with only required scopes.
4. Use it with the dev API base URL:

Token for production environment

1. Create a separate production key (do not reuse the dev key).
2. Assign only required production scopes.
3. Use it with the production API base URL:

Recommended: keep separate keys per app/environment and rotate them regularly.

Usage

Use the facade:

Rent a server (typed wrapper)

You can call server rent directly via facade with typed parameters:

Validation behavior:

• required parameters (gameShort, planId) must be present
• invalid values (for example wrong region or instanceCount < 1) throw an exception before the HTTP request
• for pre-validation of gameShort, use RespawnHost::gameByShort($gameShort) before rent

Public game catalog (typed models)

The package now supports these public catalog endpoints:

• GET /api/games
• GET /api/games/short/{game_short}
• GET /api/games/short/{game_short}/packages

These endpoints are fetched through the SDK without requiring RESPAWNHOST_API_KEY.

Usage:

These methods return immutable DTO-style classes:

• TobiSchulz\LaravelRespawnHostSdk\Models\CatalogGame
• TobiSchulz\LaravelRespawnHostSdk\Models\CatalogGamePackage

Payments and transactions:

For endpoints that are not wrapped yet, use the generic request method:

Error handling:

Development

Roadmap

• expand endpoint coverage based on OpenAPI tags:
  • servers/* (files, backups, schedules, shares, minecraft, databases)
  • payments
  • transactions
• add request/response DTOs and stronger typing
• add contract tests for critical workflows (rent, powerstate, backups, billing)

Detailed endpoint mapping is tracked in docs/API-COVERAGE.md.

License

MIT. See LICENSE.md.