Partner API
Szerveroldali API partnereknek: hozz létre ügyfeleket, rendelj csomagokat és kezeld az előfizetéseket saját webhelyedről vagy botodból.
A Partner API-val saját webhelyet, ügyfélportált vagy botot építhetsz a CreateYourVPN-re. Csak ügyfeleket, csomagokat és előfizetéseket tesz elérhetővé; szerverek, csomópontok, panelek és infrastruktúra-hitelesítő adatok soha nem jelennek meg a válaszokban.
A kulcs kizárólag szerverek közötti használatra való. Soha ne tedd JavaScriptbe vagy mobilalkalmazásba. A böngészőből érkezőnek tűnő kéréseket a rendszer 403 browser_forbidden hibával elutasítja.
Első lépések
- Nyisd meg a panelen a Beállítások → API és integrációk részt.
- Hozz létre minimális jogosultságú kulcsot, és másold ki a titkot; csak egyszer jelenik meg.
- Küldd
Authorization: Bearer cyv_live_…vagyX-API-Keyfejlécként.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Jogosultságok: config:read a konfigurációhoz és helyszínekhez, users:read az ügyfelek olvasásához, users:write az ügyfelek létrehozásához és előfizetéseik kezeléséhez.
Nyilvános szerződés
A nyilvános Postman-gyűjtemény tartalmaz minden endpointot, paramétert, törzset, példát, jogosultságot és hibakódot. A backend szerződéséből készül, ezért ez az egyetlen technikai referencia.
Korlátok: kulcsonként 120 kérés percenként, a GET /users esetén 10 percenként. A grant, rotate és DELETE műveletekhez Idempotency-Key szükséges; ugyanazon esemény ismétléseinél 24 órán át ugyanazt az értéket használd.
Visszaállítás mentésből
Két módja annak, hogy visszahozd a felhasználóidat: az egykattintásos vezérlőpulti visszaállítás, amely idempotens módon importálja őket újra, vagy a kézi visszaállítás egy üres Marzbanba, mivel a fájl natív Marzban felhasználóformátumú.
Vészhelyzeti hozzáférés
Tartalék csatlakozási mód arra az esetre, amikor a hálózat engedélyezési listát használ, és a fő kapcsolat blokkolva van — hozzon létre egy videohívást, adja át a linkjét a fiókjából vagy e-mailben, és kész kapcsolatot kap.