Partnerské API
Serverové API pro partnery: vytvářejte klienty, přidělujte tarify a spravujte předplatná z vlastního webu nebo bota.
Partnerské API umožňuje vytvořit vlastní web, klientský portál nebo bota nad CreateYourVPN. Zpřístupňuje pouze klienty, tarify a předplatná; servery, uzly, panely ani přístupové údaje infrastruktury se v odpovědích nikdy neobjeví.
Klíč je určen pouze pro komunikaci server–server. API keys are stored on the server and are not included in browser or mobile application code. Požadavky odeslané z prohlížeče vracejí HTTP 403 (browser_forbidden).
Začínáme
- V panelu otevřete Nastavení → API a integrace.
- Vytvořte klíč s minimálními právy a zkopírujte tajnou část; zobrazí se jen jednou.
- Posílejte ho jako
Authorization: Bearer cyv_live_…neboX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Oprávnění: config:read pro konfiguraci a lokality, users:read pro čtení klientů a users:write pro vytváření klientů a správu předplatných.
Veřejný kontrakt
Veřejná kolekce Postman obsahuje všechny endpointy, parametry, těla, příklady, oprávnění a chybové kódy. Generuje se z kontraktu backendu a je jedinou technickou referencí.
Limity: 120 požadavků za minutu na klíč a 10 za minutu pro GET /users. grant, rotate a DELETE vyžadují Idempotency-Key; pro opakování stejné události používejte 24 hodin stejnou hodnotu.
Obnovení ze zálohy
Dvě cesty, jak vrátit své uživatele zpět: obnovení jedním kliknutím přímo v dashboardu, které je znovu naimportuje idempotentně, nebo ruční obnovení do prázdného Marzbanu, protože soubor je v nativním formátu uživatelů Marzbanu.
Nouzový přístup
Záložní způsob, jak se připojit, když síť používá seznamy povolených služeb a běžné připojení je zablokované — vytvoříte videohovor, předáte nám jeho odkaz ze svého účtu nebo e-mailem a dostanete hotové připojení.