Wie erhalte ich einen API Key?

API-Zugang einrichten: Token erstellen und verwalten

Über die Prepaid-Hoster API (v2) steuerst du deine Dienste programmatisch. Die API ist REST-basiert, verwendet JSON und wird über einen persönlichen API-Token authentifiziert.

Hinweis: Die API befindet sich aktuell noch in der Entwicklung. API-Keys stehen noch nicht generell zur Verfügung und Routen können sich noch ändern. Wir rollen das Feature nach und nach an Interessenten und anschließend alle Kunden aus.

Auf einen Blick

  • Basis-URL: https://api.pph.systems/api
  • Format: REST, JSON
  • Authentifizierung: Authorization: Bearer <API-TOKEN>
  • Die aktuell aktive API-Version wird dir direkt im API-Bereich angezeigt.

Token anlegen

  1. Melde dich in deinem Kundenbereich (Vionity) an.
  2. Öffne den Bereich API v2.
  3. Trage rechts unter Neuen Token erstellen eine Beschreibung ein, damit du den Token später wiedererkennst (zum Beispiel „Uptime Monitor“ oder „Backup-Skript“).
  4. Optional: Setze den Haken bei Mit Schreibrechten erstellen, wenn der Token nicht nur lesen, sondern auch Daten verändern soll.
  5. Klick auf Erstellen. Der Token wird dir im Format sk_live_... angezeigt.

Kopiere den Token direkt nach der Erstellung und bewahre ihn sicher auf. Über Settings kannst du ihn später jederzeit anpassen oder widerrufen.

Lese- oder Schreibrechte

Jeder Token hat eine von zwei Berechtigungsstufen, die du unter Schreibrechte einstellst:

  • Nur Lesezugriff: Der Token darf Daten ausschließlich abfragen. Ideal für Monitoring, Reporting oder Dashboards.
  • Mit Schreibrechten: Der Token darf zusätzlich Daten anlegen, ändern und löschen. Nutze diese Stufe nur, wenn dein Anwendungsfall das wirklich braucht.

Faustregel: Vergib so wenig Rechte wie möglich. Ein Monitoring-Token braucht keinen Schreibzugriff.

Authentifizierung

Sende den Token bei jeder Anfrage im Authorization-Header mit:

curl -H "Authorization: Bearer sk_live_..." \
     https://api.pph.systems/api/vps

Gated Routes: Zugriff gezielt einschränken

Standardmäßig kann ein Token alle Routen ansprechen, die seine Berechtigungsstufe erlaubt. Mit Gated Routes schränkst du das weiter ein. Ist die Funktion aktiv, darf der Token nur noch auf die Routen zugreifen, die du explizit freigibst. Jeder andere Aufruf wird mit einem HTTP 403 abgewiesen.

Eine Route gibst du unter Neue Route freigeben frei. Dabei stehen dir zwei Mechanismen zur Verfügung.

Wildcards

Statt jede Route einzeln zu pflegen, gibst du mit * ganze Gruppen frei:

  • vps.status.index gibt genau eine Route frei.
  • vps.* gibt alle VPS-Routen frei.
  • domains.records.* gibt alle DNS-Record-Routen frei.

Route-Param Binding

Über die Felder Hosting IDs und Domain IDs bindest du eine Route an konkrete Ressourcen. Der Token kann die Route dann nur für genau diese IDs nutzen.

Beispiel: Gibst du vps.* zusammen mit einer bestimmten Hosting-ID frei, darf der Token alle VPS-Aktionen ausführen, aber ausschließlich auf diesem einen Server. Lässt du die Felder leer, gilt die Route ohne Einschränkung auf einzelne Ressourcen.

So baust du dir zum Beispiel einen Token, der nur den Status eines einzelnen VPS abfragen darf und sonst nichts.

MCP-Fähigkeit

Tokens lassen sich optional für die Nutzung mit MCP-Servern (Model Context Protocol) freischalten, etwa um die API direkt an einen KI-Assistenten anzubinden. Diese Fähigkeit ist standardmäßig nicht verfügbar und wird pro Account manuell freigeschaltet. Wenn du sie nutzen möchtest, melde dich bei unserem Support.

Human in the loop (Coming soon)

Für Tokens mit Schreibrechten kannst du Human in the loop aktivieren. Bestimmte Aktionen, die der Token auslöst, müssen dann zusätzlich von einem Menschen bestätigt werden, bevor sie ausgeführt werden. Das ist sinnvoll, wenn ein Token automatisiert läuft, kritische Aktionen aber nicht ohne manuelle Freigabe durchgehen sollen.

Token widerrufen

Einen Token deaktivierst du sofort, indem du in den API-Token Details den Haken bei Token widerrufen setzt und speicherst. Ein widerrufener Token wird ab der nächsten Anfrage abgewiesen.

Noch Fragen?

Technische Fragen zur API beantworten dir unsere Entwickler direkt in unserem Discord. Stell deine Frage im Entwickler-Channel und pinge das Dev-Team an.

Wie lange ist mein Guthaben gültig?

Aufgeladenes und ungenutztes Guthaben verliert bei uns in der Regel nicht seine Gültigkeit. Du kannst es jederzeit verwenden, solange dein Kundenkonto bei Prepaid-Hoster aktiv ist. Dein Guthaben lässt sich flexibel für alle unsere verfügbaren Produkte einsetzen. Du kannst damit beispielsweise Server, Domains oder Lizenzen mieten.

Bitte beachte jedoch unsere Richtlinien zur DSGVO. Wir sind möglicherweise dazu verpflichtet, die Daten von dauerhaft inaktiven Kundenkonten zu entfernen. Bevor wir einen Account deaktivieren, kontaktieren wir dich selbstverständlich 30 Tage im Voraus per E-Mail. Solltest du deinen Account selbst löschen lassen und eine Auszahlung des restlichen Guthabens ist nicht möglich, verfällt dieses.

Sonderguthaben

Für Guthaben aus speziellen Aktionen können abweichende Regeln gelten. Wir behalten uns vor, die Verwendbarkeit von Sonderguthaben zeitlich zu begrenzen. Falls es eine solche Einschränkung gibt, kommunizieren wir dies stets transparent im Vorfeld der jeweiligen Aktion. Gibt es keine zeitliche Begrenzung, verbleibt das Sonderguthaben auf deinem Kundenkonto. Eine Auszahlung von Sonderguthaben ist generell ausgeschlossen.

Grafik-Rendering auf Windows Server

Kann ich Spiele auf einem Windows Server unter KVM spielen?

Bei einem Windows Server unter KVM steht keine dedizierte Grafikkarte zur Verfügung. Aus diesem Grund ist es nicht möglich, Spiele auf dem Server zu spielen oder darauf zuzugreifen, da diese eine Grafikkarte benötigen.

Gibt es Workarounds?

Somit ist auch das Rendering von komplexen 3D-Modellen oder die Ausführung grafikintensiver Anwendungen auf einem Windows Server unter KVM eingeschränkt. Es gibt zwar bestimmte Workarounds und Lösungen wie z.B. die Verwendung von Remote-Desktop-Diensten oder GPU-Passthrough-Technologien, um Grafikkarten auf virtuellen Maschinen bereitzustellen. Allerdings passen diese nicht in unsere Infrastruktur.

Eine effektive Lösung für den Zugriff auf eine Grafikeinheit ist die Verwendung eines Dedicated Servers. Hierbei hast Du Zugriff auf eine integrierte Grafikeinheit im Prozessor, deren Leistung jedoch je nach Prozessortyp variiert.

KVM Server ungeeignet

Bitte beachte, dass KVM eine Virtualisierungstechnologie ist und dafür ausgelegt ist, serverbasierte Anwendungen und Dienste zu hosten. Es ist nicht dafür gedacht, Desktop-Anwendungen oder Spiele zu hosten. Wenn Du einen Server für Spiele benötigst, empfehlen wir Dir, einen dedizierten Spiele-Server oder eine andere dedizierte Hosting-Lösung zu verwenden, die speziell für diesen Zweck entwickelt wurde.

Meine IP-Adresse ist auf einer Block-List

Wenn Deine IP-Adresse auf einer Block-Liste steht, kann das verschiedene Gründe haben. Manche Listen tragen IPs ein, von denen tatsächlich Spam verschickt wurde. Andere listen vorsorglich ganze Adressbereiche, etwa weil sie früher für private Internetanschlüsse genutzt wurden. In beiden Fällen kann es passieren, dass E-Mails von Deinem Server bei Providern wie Gmail oder Yahoo abgelehnt werden.

Die Fehlermeldung kann dann etwa so aussehen:

SMTP error 550: 5.7.1 
Recipient not authorized, your IP has been found on a block list

Wie finde ich heraus, ob meine IP auf einer Block-Liste steht?

Das siehst Du direkt im Cloud Manager: Im Bereich Monitoring zeigt die Zeile IP Blacklist, ob Deine IPv4-Adresse bei gängigen Listen wie Spamhaus, SpamCop oder UCEPROTECT eingetragen ist.

Cloud Manager mit IP-Blacklist-Check im Bereich Monitoring
Blacklist-Status Deiner IP-Adresse im Cloud Manager: Alles ok.

Nicht jeder Eintrag bedeutet, dass von Deiner IP Spam verschickt wurde. Steht sie nur auf der Spamhaus PBL, kannst Du sie meist selbst delisten. Wie Du die anderen Treffer einordnest, erfährst Du unter Wie finde ich heraus, ob mein vServer auf einer Blacklist steht?

Besonders lästig: Outlook

Erfahre warum Microsoft einige IP-Adressbereiche blockiert hat und wie wir daran arbeiten, um die Zustellungsqualität der E-Mails zu verbessern.

Warum kann ich keine E-Mails an Gmail oder andere E-Mail-Provider senden, wenn meine IP-Adresse auf einer Block-Liste steht?

E-Mail-Provider verwenden Block-Listen, um unerwünschte E-Mails und Spam zu filtern. Wenn Deine IP-Adresse auf einer Block-Liste steht, kann dies dazu führen, dass die E-Mails, die von Deinem Server gesendet werden, von diesen Providern blockiert werden. Dies kann dazu führen, dass wichtige E-Mails nicht zugestellt werden und Deine Kommunikation beeinträchtigt wird.

Was kann ich tun, wenn meine IP-Adresse auf einer Block-Liste steht?

Wenn Deine IP-Adresse auf einer Block-Liste steht, solltest Du Dich an unseren Kundensupport wenden. Wir können Dir „saubere“ IP-Adressen bereitstellen, die nicht auf Block-Listen stehen. Dadurch wird sichergestellt, dass Deine E-Mails zugestellt werden und Deine Kommunikation reibungslos verläuft. Beachte jedoch, dass wir in diesem Fall erfahren müssen, welche Art von Mail-Verkehr du versendest. Für Privatanwendungen finden wir garantiert immer eine Lösung. Für größere Vorhaben, beispielsweise transaktionelle Mails, empfehlen wir dir andere Lösungen.

DKIM & SPF nutzen

Die Verwendung von DKIM und SPF kann die Zustellung von E-Mails verbessern, indem sie die Authentizität der E-Mails überprüfen und sicherstellen, dass sie von einem vertrauenswürdigen Absender stammen.

DKIM (DomainKeys Identified Mail) ist ein Verfahren zur Überprüfung der Authentizität von E-Mails durch digitale Signaturen. Dabei wird eine digitale Signatur in den Header der E-Mail eingebettet, die von der empfangenden Domain überprüft wird. Wenn die Signatur gültig ist, wird die E-Mail als authentisch eingestuft und die Zustellung wird erleichtert.

SPF (Sender Policy Framework) hingegen ist ein System, das verhindert, dass E-Mails von nicht autorisierten Servern gesendet werden. Dabei wird im DNS-Record der Domain ein Eintrag erstellt, der angibt, welche Server berechtigt sind, E-Mails im Namen der Domain zu senden. Wenn die empfangende Domain überprüft, ob der Server, der die E-Mail sendet, in der SPF-Aufzeichnung der Absender-Domain aufgeführt ist, wird die E-Mail zugestellt.

Durch die Verwendung von DKIM und SPF kann die Zustellung von E-Mails verbessert werden, da diese Systeme die Echtheit der E-Mail überprüfen und sicherstellen, dass sie von einem vertrauenswürdigen Absender stammen. Dies verringert das Risiko, dass E-Mails von Spam-Filtern blockiert oder in den Spam-Ordner verschoben werden, was zu einer höheren Zustellrate und einer verbesserten Kommunikation führt.

Warum hat meine Rechnung keine Mehrwertsteuer?

Die Rechnungen für unsere Server, Domains und Lizenzen werden generell mit Deinem Account-Guthaben bezahlt. Da die Mehrwertsteuer bereits bei der Aufladung Deines Guthabens erhoben wird, entfällt sie bei den Dienstleistungs-Rechnungen. Aus diesem Grund wird keine Mehrwertsteuer auf einigen Deiner Rechnungen ausgewiesen.

Daher gilt:

  • Guthaben aufladen: Mehrwertsteuer ausgewiesen
  • Server kaufen/verlängern: Keine Mehrwertsteuer ausgewiesen

(Wo) kann ich Rechnungen mit Mehrwertsteuer erhalten?

Wenn Du eine Transaktion durchführst oder Dein Account-Guthaben auflädst, wird die Mehrwertsteuer ausgewiesen und auf der entsprechenden Rechnung aufgeführt. Du kannst diese Rechnungen im Webinterface unter https://www.vionity.de/clientarea/my/transactions herunterladen.

Insgesamt ist es normal, dass Rechnungen für unsere Server, Domains und Lizenzen keine Mehrwertsteuer enthalten, da diese bereits bei der Aufladung des Guthabens erhoben wird. Wenn Du weitere Fragen zu Deinen Rechnungen hast oder eine Rechnung mit Mehrwertsteuer benötigst, kannst Du Dich jederzeit an unseren Kundensupport wenden.

Wo finde ich euren Discord Server?

Server-Adresse

Unser Prepaid Hoster Discord Server ist unter dem Link pph.sh/discord zu finden. Dort findest Du eine nette Community, die bei Fragen und Problemen gerne weiterhilft. Auch der Entwickler des Webinterfaces und Supporter sind auf dem Server aktiv und stehen Dir mit Rat und Tat zur Seite.

PPH Discord Server

OnlyFans

Kennst Du schon unseren heißen Only-Fans Account? Eine Kostprobe: https://pp-h.eu/onlyfans

Regeln unseres Discord-Servers

  • Wir tolerieren ausschließlich einen guten Umgangston und freundliches Miteinander.
  • Für Reports oder Regelverstöße ist die Report-Funktion der Bots zu nutzen, nicht einen Inhaber, Team-Mitglied oder Moderator privat deswegen anschreiben.
  • Der Discord-Server ist kein offizieller Support-Channel.
  • Team- und Community-Mitglieder dürfen wegen Problemen mit Diensten von Prepaid-Hoster nicht persönlich/privat angeschrieben werden, nur auf ausdrückliche Einladung.
  • IP-Adressen, Domains und personenbezogene Daten sollten nach Möglichkeit nicht gepostet werden.
  • Es darf ausschließlich “Family Friendly” Content gepostet werden. Das gilt auch für den Offtopic-Bereich.
  • Wir erlauben keinerlei Werbung für eigene Server, Seiten, Projekte und insbesondere andere Hostings.
  • Bitte bleibt auch bei Ausfällen oder Problemen jederzeit freundlich. Wir garantieren Dir, dass wir unser bestes geben!
  • Channels sollen für die vorgesehenen Themen verwendet werden. Offtopic darf im Allgemein-Channel geschrieben werden.
  • Feedback soll stets konstruktiv und nicht destruktiv gestaltet sein.
  • Team-Mitglieder und Mods können diese Regeln nach eigenem Ermessen durchsetzen.
  • Das Anbieten von Guthaben, Tauschgeschäften oder ähnliches jeglicher Art ist untersagt.

Kann ich meinen Server im Voraus verlängern?

Nein, eine Verlängerung im Voraus gibt es nicht. Das musst du aber auch nicht: Liegt 7 Tage vor Ablauf genug Guthaben auf deinem Konto, verlängert sich dein Server automatisch um den vollen gewählten Zeitraum. Willst du auf Nummer sicher gehen, lädst du einfach rechtzeitig Guthaben auf.

Warum keine Vorausverlängerung? Sie würde mit der sofortigen Rückgabe kollidieren, bei der du die Restlaufzeit als Guthaben zurückbekommst.

So läuft die Verlängerung ab

  1. 7 Tage vor Ablauf erstellt das System den Beleg für die Verlängerung und schickt dir eine Mail.
  2. Ist genug Guthaben da, wird der Beleg direkt bezahlt und dein Server läuft weiter.
  3. Lädst du erst nach der Erstellung des Belegs auf, wird er nicht automatisch bezahlt. Weise das Guthaben dem Beleg dann im Webinterface unter „Guthaben und Rechnungen“ selbst zu.

Was passiert ohne Guthaben?

Ist der Beleg zum Stichtag nicht bezahlt, wird dein Server gesperrt. 3 Tage vor der Löschung bekommst du noch eine Erinnerung, 7 Tage nach der Sperre wird der Server mit allen Daten und Backups gelöscht. Bis dahin kannst du ihn durch Aufladen und Bezahlen des Belegs noch retten. Bei Dedicated Servern gibt es diese Frist nicht, sie enden genau zum Stichtag.

Damit das nicht passiert, kannst du Guthaben automatisch aufladen, per PayPal-Abo oder Dauerauftrag. Alles zum Aufladen: Wie lade ich Guthaben auf?

Zahlungszeitraum und Stichtag ändern

  • Den Zahlungszeitraum ändert dir der Support: 1, 3, 6 oder 12 Monate.
  • Hast du mehrere Server, legen wir ihre Laufzeiten auf Wunsch kostenlos auf einen gemeinsamen Termin. Schreib dazu einfach ein Ticket.

Du willst den Server gar nicht verlängern? Dann lies Wie kündige ich meinen Server?

Wie kann ich meinen Server neu installieren?

Die Neuinstallation Deines virtuellen Servers über das Webinterface ist sehr einfach. Im Cloud Manager findest Du unter den Aktionen die Option „Neu installieren“. Dort kannst Du den Server neu installieren oder das Betriebssystem wechseln. Bitte beachte, dass bei einer Neuinstallation alle Daten gelöscht werden und der Server somit zurückgesetzt wird. Es ist jedoch jederzeit möglich, eine Neuinstallation durchzuführen.

Neu Installation – Zurücksetzen des Servers Dialog

Wie funktioniert die Neuinstallation meines virtuellen Servers?

Um Deinen virtuellen Server neu zu installieren, navigiere im Cloud Manager zu den Aktionen und wähle „Neu installieren“ aus. Dort kannst Du das gewünschte Betriebssystem auswählen oder den Server komplett neu installieren. Bitte beachte, dass bei einer Neuinstallation alle Daten gelöscht werden, daher solltest Du unbedingt vorher eine Datensicherung durchführen.

Aktionen im Webinterface

Kann ich das Betriebssystem meines virtuellen Servers wechseln?

Ja, im Cloud Manager hast Du die Möglichkeit, das Betriebssystem Deines virtuellen Servers zu wechseln. Wähle einfach die Option „Neu installieren“ aus und wähle das gewünschte Betriebssystem aus. Bitte beachte jedoch, dass bei einem Betriebssystemwechsel alle Daten auf dem Server gelöscht werden und Du eine Datensicherung durchführen solltest.

Ist eine Neuinstallation meines virtuellen Servers jederzeit möglich?

Ja, eine Neuinstallation Deines virtuellen Servers ist jederzeit möglich. Navigiere einfach zum Cloud Manager und wähle die Option „Neu installieren“ aus, um den Server zurückzusetzen oder das Betriebssystem zu wechseln. Bitte beachte jedoch, dass bei einer Neuinstallation alle Daten gelöscht werden und Du eine Datensicherung durchführen solltest, wenn Du wichtige Daten auf dem Server hast.

Wie kann ich meinen Account löschen?

Wenn Du Deinen Account löschen möchtest, sind einige Schritte zu beachten. Zunächst müssen alle Dienste wie Server und Domains gekündigt werden und dürfen nicht mehr aktiv sein. Wenn Du noch Guthaben auf Deinem Account hast, verfällt dieses mit der Löschung des Accounts. Bitte beachte, dass Du vor der Löschung Deines Accounts den Kundensupport kontaktieren solltest, um den Prozess zu starten.

Wie erfolgt die Löschung meines Accounts?

Sobald Du den Kundensupport kontaktiert hast, werden Dein Account und alle persönlichen Daten gemäß der Datenschutzgrundverordnung (DSGVO) anonymisiert. Das bedeutet, dass Deine persönlichen Daten, wie Name und Adresse, aus unseren Systemen entfernt werden. Bitte beachte, dass wir gesetzliche Fristen für die Aufbewahrung von Rechnungen und Transaktions-Informationen einhalten müssen, daher können diese Informationen nicht gelöscht werden.

Was passiert mit meinen persönlichen Daten?

Deine persönlichen Daten werden gemäß der Datenschutzgrundverordnung (DSGVO) anonymisiert und aus unseren Systemen entfernt. Nach dem Anonymisieren deiner Daten ist der Login deaktiviert.

Kann ich meinen Account reaktivieren, nachdem er gelöscht wurde?

Nein, es ist nicht möglich, einen gelöschten Account wiederherzustellen. Denn gemäß DSGVO ist nach einer Löschung, Anonymisierung oder Pseudonymisierung keine Möglichkeit mehr gegeben, den Account einer natürlichen Person zuzuweisen. Wenn Du jedoch unsere Dienste erneut nutzen möchtest, kannst Du einen neuen Account erstellen und die gewünschten Dienste bestellen.

Wie lange dauert der Löschprozess meines Accounts?

Nachdem Du eine Anfrage zur Löschung Deines Accounts gestellt hast, wird dieser von einem Mitarbeiter des Kundensupports umgehend anonymisiert. Sobald der Account anonymisiert wurde, ist kein Login und keine Kontaktaufnahme mehr möglich. Aufgrund technischer Prozesse kann es bis zu 24 Stunden dauern, bis die Anonymisierung in allen Systemen vollständig durchgeführt wurde. Bitte beachte, dass die Anonymisierung automatisch durchgeführt wird.

Domain-Status: Pending Transfer

Wenn du eine Domain zu Prepaid-Hoster umziehst, geht das normalerweise ganz schnell.

Während des Domain-Transfers kann es allerdings bei einigen TLDs (Top-Level-Domains) zu einer sogenannten „Pending Transfer“-Phase kommen, die bis zu 7 Tage dauern kann.

Während dieser Zeit überprüft der derzeitige Registrar den Domain-Transfer und stellt sicher, dass alle Informationen korrekt sind. Wenn es während dieser Phase keine Probleme gibt, wird der Domain-Transfer abgeschlossen und die Domain wird zum zukünftigen Registrar übertragen. Wir haben unsererseits keinerlei Einfluss auf die Dauer eines Transfers.

Wenn Du eine Domain-Transfer-Bestellung aufgegeben hast und der Status „Pending Transfer“ angezeigt wird, empfehlen wir Dir, etwas Geduld zu haben. Unsere beliebtesten TLDs (.DE und .EU) werden innerhalb von Sekunden nach der Transfer-Anfrage automatisch an uns übertragen, aber bei TLDs wie .NET und .COM kann der Transfer-Prozess bis zu 7 Tage dauern, was zu einem vorübergehenden „Pending Transfer“-Status führen kann. Wenn Du jedoch weitere Informationen benötigst, stehe ich Dir gerne zur Verfügung und gebe Dir jederzeit Auskunft über den aktuellen Stand des Transfers.