Download the PHP package multiplayer-gratis/api-client without Composer
On this page you can find all versions of the php package multiplayer-gratis/api-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download multiplayer-gratis/api-client
More information about multiplayer-gratis/api-client
Files in multiplayer-gratis/api-client
Package api-client
Short Description PHP-Client für die REST-API von multiplayer.gratis – kostenloses Gameserver-Hosting.
License MIT
Homepage https://multiplayer.gratis
Informations about the package api-client
multiplayer.gratis PHP API Client
PHP-Client für die REST-API von multiplayer.gratis – kostenloses Gameserver-Hosting.
Installation
Voraussetzungen: PHP 8.1+, ext-curl, ext-json.
Authentifizierung
Erstelle einen API-Schlüssel im Dashboard unter API. Behandle ihn wie ein Passwort – am besten aus einer Umgebungsvariable laden statt ihn im Code zu hinterlegen.
Verwendung
Alle Methoden geben die JSON-Antwort der API als assoziatives Array zurück.
| Methode | Endpunkt |
|---|---|
getAccount() |
GET /account |
getServers() |
GET /servers |
getServer($id) |
GET /servers/{id} |
getServerResources($id) |
GET /servers/{id}/resources |
sendPowerSignal($id, $signal) |
POST /servers/{id}/power |
Fehlerbehandlung
Fehler der API ({ "error": "…" }) werden als Exceptions geworfen. Alle erben von MultiplayerGratis\Exception\ApiException.
| Status | Exception | Bedeutung |
|---|---|---|
| 401 | AuthenticationException |
Schlüssel fehlt oder ist ungültig |
| 404 | NotFoundException |
Server nicht gefunden |
| 409 | ConflictException |
Server abgelaufen oder nicht steuerbar |
| 423 | LockedException |
Vom Team gesperrt |
| 429 | RateLimitException |
Mehr als 60 Anfragen pro Minute |
| – | TransportException |
API nicht erreichbar (Netzwerkfehler) |
Eigener HTTP-Transport
Standardmäßig wird cURL genutzt. Timeouts lassen sich anpassen oder ein eigener Transport über HttpClientInterface übergeben (z. B. für Tests):
Tests
Lizenz
MIT – siehe LICENSE.
All versions of api-client with dependencies
ext-curl Version *
ext-json Version *