API partnerskie
Serwerowe API dla partnerów: twórz klientów, przyznawaj plany i zarządzaj subskrypcjami z własnej strony lub bota.
API partnerskie pozwala zbudować własną stronę, panel klienta lub bota na bazie CreateYourVPN. Udostępnia tylko klientów, plany i subskrypcje; serwery, węzły, panele i dane dostępowe infrastruktury nigdy nie trafiają do odpowiedzi.
Klucz służy wyłącznie do komunikacji serwer–serwer. Nigdy nie umieszczaj go w JavaScript ani aplikacji mobilnej. Żądania wyglądające na przeglądarkowe są odrzucane kodem 403 browser_forbidden.
Pierwsze kroki
- Otwórz w panelu Ustawienia → API i integracje.
- Utwórz klucz z minimalnymi uprawnieniami i skopiuj sekret; zostanie pokazany tylko raz.
- Wyślij go jako
Authorization: Bearer cyv_live_…lubX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Uprawnienia: config:read do konfiguracji i lokalizacji, users:read do odczytu klientów oraz users:write do tworzenia klientów i zarządzania subskrypcjami.
Publiczny kontrakt
Publiczna kolekcja Postman zawiera wszystkie endpointy, parametry, body, przykłady, uprawnienia i kody błędów. Jest generowana z kontraktu backendu i stanowi jedyne źródło dokumentacji technicznej.
Limity: 120 żądań na minutę na klucz i 10 na minutę dla GET /users. grant, rotate i DELETE wymagają Idempotency-Key; przez 24 godziny używaj tej samej wartości dla ponowień tego samego zdarzenia.
Przywróć z kopii zapasowej
Dwa sposoby na odzyskanie użytkowników: przywracanie jednym kliknięciem z panelu, które importuje ich ponownie w sposób idempotentny, albo ręczne przywracanie do „czystego” Marzbana, ponieważ plik ma natywny format użytkownika Marzban.
Dostęp awaryjny
Zapasowy sposób połączenia, gdy sieć korzysta z białych list, a zwykłe połączenie jest zablokowane — utwórz rozmowę wideo, przekaż nam jej link z panelu albo e-mailem i odbierz gotowe połączenie.