Partnerské API
Serverové API pre partnerov: vytvárajte klientov, prideľujte programy a spravujte predplatné z vlastného webu alebo bota.
Partnerské API umožňuje vytvoriť vlastný web, klientsky portál alebo bota nad CreateYourVPN. Sprístupňuje iba klientov, programy a predplatné; servery, uzly, panely ani prístupové údaje infraštruktúry sa v odpovediach nikdy neobjavia.
Kľúč je určený iba na komunikáciu server–server. Nevkladajte ho do JavaScriptu ani mobilnej aplikácie. Požiadavky vyzerajúce ako z prehliadača sú odmietnuté chybou 403 browser_forbidden.
Začíname
- V paneli otvorte Nastavenia → API a integrácie.
- Vytvorte kľúč s minimálnymi oprávneniami a skopírujte tajnú časť; zobrazí sa iba raz.
- Posielajte ho ako
Authorization: Bearer cyv_live_…aleboX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Oprávnenia: config:read pre konfiguráciu a lokality, users:read na čítanie klientov a users:write na vytváranie klientov a správu predplatného.
Verejný kontrakt
Verejná kolekcia Postman obsahuje všetky endpointy, parametre, telá, príklady, oprávnenia a chybové kódy. Generuje sa z backend kontraktu a je jedinou technickou referenciou.
Limity: 120 požiadaviek za minútu na kľúč a 10 za minútu pre GET /users. grant, rotate a DELETE vyžadujú Idempotency-Key; pri opakovaní rovnakej udalosti používajte 24 hodín rovnakú hodnotu.
Obnovenie zo zálohy
Dva spôsoby, ako vrátiť späť svojich používateľov: obnovenie na jedno kliknutie v paneli, ktoré ich idempotentne znovu importuje, alebo manuálne obnovenie do prázdneho Marzbanu, keďže súbor je v natívnom formáte používateľov Marzbanu.
Núdzový prístup
Záložný spôsob pripojenia, keď sieť používa zoznamy povolených služieb a bežné pripojenie je zablokované — vytvorte videohovor, odovzdajte nám naň odkaz zo svojho účtu alebo e-mailom a dostanete hotové pripojenie.