Partner-API
Server-API für Partner: Kunden anlegen, Tarife vergeben und Abonnements über die eigene Website oder einen Bot verwalten.
Mit der Partner-API kannst du auf CreateYourVPN eine eigene Website, ein eigenes Kundenportal oder einen Bot aufbauen. Sie stellt nur Kunden, Tarife und Abonnements bereit; Server, Nodes, Panels und Infrastruktur-Zugangsdaten erscheinen nie in Antworten.
Der Schlüssel ist ausschließlich für Server-zu-Server-Aufrufe bestimmt. Lege ihn niemals in JavaScript oder einer mobilen App ab. Browserähnliche Anfragen werden mit 403 browser_forbidden abgelehnt.
Erste Schritte
- Öffne im Dashboard Einstellungen → API und Integrationen.
- Erstelle einen Schlüssel mit den minimal nötigen Rechten und kopiere das Geheimnis; es wird nur einmal angezeigt.
- Sende ihn als
Authorization: Bearer cyv_live_…oderX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Verfügbare Rechte: config:read für Konfiguration und Standorte, users:read zum Lesen von Kunden und users:write zum Anlegen von Kunden und Verwalten ihrer Abonnements.
Öffentlicher Vertrag
Die öffentliche Postman-Collection enthält alle Endpunkte, Parameter, Request-Bodys, Beispiele, Rechte und Fehlercodes. Sie wird aus dem Backend-Vertrag erzeugt und ist damit die einzige technische Referenz.
Limits: 120 Anfragen pro Minute und Schlüssel, für GET /users 10 pro Minute. grant, rotate und DELETE benötigen einen Idempotency-Key; verwende für alle Wiederholungen desselben Ereignisses 24 Stunden lang denselben Wert.
Aus einem Backup wiederherstellen
Zwei Wege, deine Benutzer zurückzuholen: die Ein-Klick-Wiederherstellung im Dashboard, die sie idempotent erneut importiert, oder eine manuelle Wiederherstellung in ein leeres Marzban, da die Datei im nativen Marzban-Benutzerformat vorliegt.
Notfallzugang
Eine Ersatzverbindung für Netze mit Zulassungslisten, in denen die normale Verbindung blockiert ist — erstelle einen Videoanruf, gib uns seinen Link aus deinem Konto oder per E-Mail und bekomme eine einsatzbereite Verbindung.