Portal-API — Einführung

Fast alles was Sie im WTS-Portal per Klick machen können, geht auch per API. Praktisch für Automatisierung, Integrationen und eigene Dashboards.

API-Basis

URL: https://www.waerner-techservices.de/api/
Format: JSON (Request-Body und Response)
Auth: Bearer-Token
Versionierung: aktuell v1, in URL-Pfad wenn nötig

Erste Anfrage: Konto-Info

Bash

curl -X GET \
  https://www.waerner-techservices.de/api/account/me \
  -H "Authorization: Bearer DEIN_TOKEN"

Response:

JSON

{
  "success": true,
  "user": {
    "email": "Ihr@konto.de",
    "name": "Lukas Wärner",
    "created_at": "2022-11-02T07:04:27Z"
  }
}

Was die API kann

Domains verwalten — registrieren, Nameserver ändern, DNS-Records
VPS steuern — reboot, snapshot, reinstall
E-Mail — Postfächer anlegen, Aliase, Weiterleitungen
Rechnungen abrufen — als JSON oder PDF-URL
Support-Tickets — erstellen und lesen

Vollständige Referenz: https://docs.waerner-techservices.de/api

Was die API nicht kann

Passwort ändern (bewusst nicht per API)
2FA konfigurieren
Kontoinhaber-Übertragung
Rechtsbindende Aktionen (Vertragsabschluss > 100 €)

Für diese Aktionen müssen Sie sich im Portal einloggen — Sicherheit über Bequemlichkeit.

Rate-Limits

Standard-Konto: 60 Requests / Minute
Business: 300 Requests / Minute
Enterprise: unbegrenzt (Fair Use)

Bei Überschreitung: HTTP 429 mit Retry-After Header.

HTTP-Status-Codes

200 OK — Erfolg
201 Created — neu erstellt
400 Bad Request — Fehler in Parametern
401 Unauthorized — Token fehlt oder ungültig
403 Forbidden — nicht berechtigt für diese Aktion
404 Not Found — Ressource existiert nicht
429 Too Many Requests — Rate-Limit erreicht
500 Internal Server Error — unser Problem, Ticket öffnen

Fehler-Response

JSON

{
  "success": false,
  "error": {
    "code": "INVALID_DOMAIN",
    "message": "Domain-Format ungültig",
    "details": { "domain": "test..de" }
  }
}

Client-Bibliotheken

Wir bieten offizielle SDKs:

PHP: composer require wts/api
Python: pip install wts-api
Node.js: npm install @wts/api
Go: go get github.com/wts/api-go

Alle auf GitHub open source.

Community-Integrationen

Von Nutzern erstellt:

Ansible — VPS-Provisionierung
Terraform Provider — Infrastructure-as-Code
HomeAssistant — DynDNS via WTS
UniFi — dynamische DNS-Updates

Hat Ihnen diese Anleitung geholfen?