In Entwicklung

Die API ist aktuell in Entwicklung und wird im August 2026 veröffentlicht.

Curl dir deine Welt, wie sie dir gefällt!

Code-First Infrastruktur: Die Prepaid-Hoster REST API

Steuere Server, Domains, DNS und Billing direkt über deinen eigenen Code. Kostenlos für jeden Kundenaccount.

Du hast Code im Blut? Schluss mit manuellem Klicken im Webinterface. Mit der Prepaid-Hoster API bindest du deine gesamte Server- und Domain-Infrastruktur direkt in CI/CD-Pipelines, eigene Kundenportale, SaaS-Backends oder Automation-Skripte ein.

  • Vollständiger Zugriff: Alle Kernfunktionen von Vionity stehen dir programmatisch zur Verfügung.
  • Keine Extrakosten: Der API-Zugriff ist für alle Kunden kostenlos freigeschaltet.
  • Echtzeit-Feedback: Transparente Task-Logs, Guest-Agent-Kommandos und detaillierter Server-Status.

Wir bieten dir:

  • Reselling auf Prepaid-Basis, also eine echte VPS Reseller API
  • Eigenes Hosting-Tagging für interne Zuweisungen
  • VPS API von Bestellung, über Installation, zur automatischen Nutzung bis zur automatischen Kündigung
  • Bring your own Webinterface: Bastel dir einfach deinen eigenen Cloud Manager
  • Einen kostenlosen Test-Account über den Support (in diesem Fall wollen wir dich aber näher kennenlernen)
  • Und bald: Einen MCP-Server, um mit deinem Account über eine LLM sprechen zu können
VPS API Server API REST API Hosting API Schnittstelle Server Cloud Server API Server automatisieren VPS automatisieren Infrastructure as Code CI/CD Server Provisioning Server per API bestellen Server per Code verwalten VPS Lifecycle Management Server Rescale API Dynamisches Rescaling Server Reboot API Guest Agent API Remote Shell Befehle SSH Key Management API Live Server Metriken Konsolen Screenshot API Snapshot API Server Backup automatisieren Cross-Server Restore Rescue System API VNC Zugriff API DNS API DNS Record API DNSSEC API DNSSEC Verwaltung Zonendatei Export BIND Zone API Domain Order API AuthCode Abfrage API Registry Task API ISO Mount API Windows Installation API RDP Zugriff API Rechnung API API Rechnungen PDF Billing API Guthaben Prognose API Transaktionsverlauf API API Token erstellen Bearer Token API API Dokumentation Hosting OpenAPI Hosting Kostenlose API Hosting Hoster mit API VPS Reseller API SaaS Backend Hosting Server Automation Script

DEV + PPH = ❤️

Prepaid-Hoster API v2

Steuere Server, Domains, DNS und Billing direkt über deinen eigenen Code. Kostenlos für jeden Kundenaccount.

Prepaid-Hoster API v2.0: Demnächst verfügbar.

Die Nachfrage zu unserer API ist in den letzten Monaten stetig gewachsen. Wir haben 2023 damit begonnen, Keys zu unserer API zu verteilen und haben dazu Feedback erhalten. Doch mit der Zeit kamen neue Anforderungen und Edge-Case Fixes in die API, während die Dokumentation in der Steinzeit stehen geblieben ist. Mittlerweile ist die API selbst Production-erprobt und wird von Vionity und dieser Webseite im Hintergrund seit Jahren täglich verwendet. Wir wissen, wie sie funktioniert. Ein Entwickler, der unsere Infrastruktur nicht kennt, fand sich darin nicht sofort zurecht.

Die Lösung: Wir haben das Feedback der Nutzer und unsere praxiserprobte Erfahrung gebündelt und eine neue API für Kunden entwickelt.

Demnächst geht die Prepaid-Hoster API v2 online. Damit kannst Du theoretisch alles machen, was du auch in Vionity kannst. 

Wir legen den Fokus der API auf unser Hauptgeschäft: Server und Domains. 

Server-Bestellungen, Upgrades (Rescale), Backups, Snapshot-Management, Rescue, ISO-Endpunkte und Windows-Installer stehen zur Verfügung. Domain-Records können angelegt, bearbeitet, validiert werden. Neu ist die DNSSEC-Verwaltung und Routen zur direkten Abfrage des AuthCodes, Registry-Task Daten (z.B. DNSSEC oder Nameserver Fehler), sowie des Registrar-Status. So siehst du technisch immer genau das, was wir im Support auch sehen.

(Stand: 14.07.2026)

Token erstellen: https://www.vionity.de/clientarea/api-tokens (bald verfügbar)

Die Prepaid-Hoster API wird für alle Kunden veröffentlicht. Der API-Zugriff ist nicht an weitere Kosten oder Produkte geknüpft. Lediglich das API-Quota Limit (Anfragen pro Minute) wird anhand der Anzahl deiner aktiven Services berechnet. 


Kernfunktionen im Überblick

1. Vollständige VPS-Automatisierung & Skalierung

Verwandle Server in flüchtige Ressourcen deiner Pipeline. Erstelle Staging-Systeme nachts automatisch und lösche sie am Morgen wieder.

  • Order & Provisioning: Server per API konfigurieren, vorkalkulieren und direkt über dein Account-Guthaben bereitstellen.
  • Lifecycle-Management: Start, Stop, Reboot, Hard-Reset und OS-Rebuild mit sekundengenauem Task-Tracking.
  • Dynamisches Rescaling: Passe CPU-Kerne, Arbeitsspeicher und Speicherplatz flexibel im laufenden Betrieb an.
  • Monitoring: Frage Traffic, Auslastungshistorie und Live-Zustände programmatisch ab.

2. Live Guest-Agent & Direktzugriff

Verwalte deine Instanzen von innen heraus, ohne vorher manuell Zugangsdaten zu verteilen.

  • Remote Commands: Führe Shell-Befehle direkt im Gastsystem aus, entweder synchron mit sofortiger Rückgabe oder asynchron im Hintergrund.
  • SSH-Key-Management: Hinterlege neue SSH-Schlüssel für Root-Logins direkt über die Schnittstelle.
  • Live-Hardware-Metriken: Lies CPU-Load, RAM-Nutzung und Festplattenbelegung in Echtzeit aus.
  • Konsolen-Screenshot: Erhalte einen Base64-Screenshot der Konsole. Das hilft sofort bei der Fehleranalyse, falls das Netzwerk streikt.

3. Backups, Snapshots & Rescue

Schütze deine Deployments und automatisiere deine Desaster-Recovery-Routinen.

  • Schnelle Snapshots: Erstelle vor riskanten Updates oder Releases point-in-time Snapshots und rolle sie bei Bedarf zurück.
  • Automatisierte Backups: Verwalte Zeitpläne, erstelle On-Demand-Sicherungen und erzeuge temporäre Download-Links.
  • Cross-Server-Restore: Stelle Backups bei Bedarf direkt auf einem anderen Ziel-VPS wieder her.
  • Rescue-System & VNC: Boote Instanzen per API in eine Rettungsumgebung oder aktiviere Out-of-Band VNC-Zugriff.

4. Domain- & DNS-Management

Perfekt für Multi-Domain-Setups, automatische ACME-Challenges und dynamische Zonen.

  • DNS-Record Upsert: Lege Records an oder aktualisiere sie intelligent nach Name und Typ, ohne vorherige ID-Prüfung.
  • Zonen-Import & Export: Exportiere BIND-kompatible Zonendateien oder spiele Zonen mit Dry-Run-Validierung ein.
  • DNSSEC & Registry-Einblick: Verwalte Delegation-Signer-Einträge (DS), Nameserver und frage Transfer-AuthCodes direkt ab.
  • Domain-Order: Prüfe Verfügbarkeiten in Echtzeit und bestelle Domains vollautomatisiert.

5. ISO-Mounts & Windows-Setups

  • Custom Images: Mounte eigene ISO-Dateien inklusive automatischer VNC-Bereitstellung für individuelle Betriebssysteme.
  • Windows-Automatisierung: Starte Windows-Installationen auf Knopfdruck und rufe RDP-Verbindungsdaten direkt ab.

6. Accounting & Account-Daten als Datenquelle

Integriere Abrechnung und Finanzübersichten nahtlos in deine Buchhaltung.

  • Rechnungs-Download: Lade Rechnungsbelege automatisiert als PDF oder JSON herunter.
  • Zukunftsprognose: Lass dir den erwarteten Guthabenbedarf für aktive Verträge im Voraus berechnen.
  • Transaktionsverlauf: Behalte Guthabenbewegungen, Zahlungsstatus und Bestellhistorien im Blick.
  • Sicherheit: Kritische oder destruktive Aktionen werden über Bestätigungs-Token zuverlässig geschützt.
Kunden-Details ansehen – bash
curl --request GET \
  --url https://api.pph.systems/api/client \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer MEIN-PPH-API-TOKEN'
Response (Beispiel)
Kunden-Details ansehen – bash
curl --request GET \
  --url https://api.pph.systems/api/vps \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer MEIN-PPH-API-TOKEN'
Response (Beispiel)

API Dokumentation

Lies dir jetzt die API Dokumentation durch.

Fragen und Antworten zur API

Beantwortet vom Dev höchstpersönlich!


Kostet der API-Zugang extra oder brauche ich ein bestimmtes Produkt?

Nein. Der API-Zugriff ist für jeden Kundenaccount kostenlos freigeschaltet, unabhängig davon welches Produkt du gebucht hast. Einzige Einschränkung: Das Rate-Limit (Anfragen pro Minute) richtet sich nach der Anzahl deiner aktiven Services. Mit einem einzelnen kleinen VPS bekommst du also ein kleineres Kontingent als ein Kunde mit zehn Servern.

Kann ich direkt Shell-Befehle auf meinem Server ausführen, ohne vorher SSH-Zugangsdaten zu verteilen?

Ja, über den Guest-Agent. Befehle lassen sich synchron mit sofortiger Rückgabe oder asynchron im Hintergrund ausführen. Dazu kommen Live-Hardware-Metriken (CPU, RAM, Disk) und ein Base64-Konsolen-Screenshot für den Fall, dass das Netzwerk selbst nicht mehr antwortet.

Ist die API produktionsreif genug für eine CI/CD-Pipeline mit nächtlichem Server-Aufbau und Abbau?

Der zugrunde liegende Unterbau läuft seit Jahren produktiv, Vionity selbst nutzt ihn intern. Für den Pipeline-Einsatz relevant: Order, Provisioning, Start/Stop/Reboot/Rebuild und dynamisches Rescaling (CPU, RAM, Storage) laufen alle mit sekundengenauem Task-Tracking, du bekommst also einen klaren Status statt Rätselraten, ob ein Vorgang durch ist.

Wo finde ich die Doku und in welcher Sprache antwortet die API?

Die Dokumentation liegt unter api.pph.systems/docs/api als OpenAPI-3.1-Spec. Ohne gesetzten Language-Header antwortet die API auf Deutsch, per Header lässt sich das umstellen. Content-Type ist durchgehend JSON, bis auf einzelne Endpunkte die PDF, Bild oder Plaintext zurückgeben.

Kann ich eigene ISO-Images mounten und darüber ein individuelles OS installieren?

Ja. Custom-Image-Mounts inklusive automatischer VNC-Bereitstellung sind vorgesehen, damit du die Installation auch live mitverfolgen kannst. Für Windows gibt es zusätzlich einen eigenen Automatisierungsweg: Installation auf Knopfdruck plus direkter Abruf der RDP-Verbindungsdaten.

Was verhindert, dass ein kompromittierter oder falsch konfigurierter Key meinen Server versehentlich löscht?

Kritische oder destruktive Aktionen laufen über ein Bestätigungs-Token-System. Ein Aufruf allein reicht nicht, die Aktion muss separat bestätigt werden, bevor sie tatsächlich ausgeführt wird. Das schützt sowohl vor kompromittierten Keys als auch vor Bugs in deinem eigenen Automatisierungscode.

Kann ich Domains und DNS-Zonen vollständig automatisieren, etwa für ACME-Challenges?

Ja. DNS-Records lassen sich per Upsert nach Name und Typ anlegen oder aktualisieren, ohne dass du vorher die ID kennen musst. Dazu kommen BIND-kompatibler Zonen-Export, Zonen-Import mit Dry-Run-Validierung, DNSSEC-Verwaltung (DS-Einträge), Nameserver-Verwaltung und direkter Abruf des Transfer-AuthCodes. Domain-Verfügbarkeit lässt sich in Echtzeit prüfen, die Bestellung selbst läuft vollautomatisiert.

Gibt es Webhooks, damit ich nicht ständig pollen muss?

Aktuell nicht, Webhooks stehen bewusst nicht im Fokus der ersten Version. Stattdessen bekommst du transparente Task-Logs mit Status pro Vorgang, mit denen sich Polling zuverlässig umsetzen lässt.

Ich nutze schon die alte API unter api.pph.sh. Muss ich umsteigen, und was ändert sich?

Die neue API unter api.pph.systems ist ein separater Neuaufbau, kein reines Update der alten Schnittstelle. Grund war, dass die alte API zwar production-erprobt lief, die Doku aber nicht mehr mit der Praxis mitgekommen ist. Ein sauberer Umstieg lohnt sich also vor allem wegen aktueller Doku und aufgeräumterer Struktur, die alte API bleibt aber vorerst nutzbar.

Ich will die API ausprobieren, ohne mein echtes Guthaben oder meine echten Server zu riskieren. Geht das?

Genau dafür gibt es unseren Integrations-Testaccount, siehe Pro-Tipp unten.

Testen direkt in der Prod?

Wir legen dir einen Test-Account an, wenn du magst.

Wer alle zehn FAQs gelesen hat, darf sich im Support melden und bekommt einen separaten Integrations-Testaccount mit 50 € Guthaben, komplett getrennt vom eigenen Account und mit eigenem API-Key. Damit lässt sich die API risikofrei durchtesten. 

Ausgeschlossen sind lediglich Domain- und Dedicated-Bestellungen, alles andere steht voll zur Verfügung.

"GIBIHM15" -15,00% auf Root Server & Webspace