Partnerski API
Poslužiteljski API za partnere: stvarajte klijente, dodjeljujte pakete i upravljajte pretplatama sa svoje stranice ili bota.
Partnerski API omogućuje izradu vlastite stranice, korisničkog portala ili bota na CreateYourVPN-u. Izlaže samo klijente, pakete i pretplate; poslužitelji, čvorovi, paneli i pristupni podaci infrastrukture nikada se ne pojavljuju u odgovorima.
Ključ je namijenjen isključivo komunikaciji poslužitelj–poslužitelj. Nemojte ga stavljati u JavaScript ili mobilnu aplikaciju. Zahtjevi koji izgledaju kao da dolaze iz preglednika odbijaju se s 403 browser_forbidden.
Početak rada
- U nadzornoj ploči otvorite Postavke → API i integracije.
- Izradite ključ s minimalnim ovlastima i kopirajte tajnu; prikazuje se samo jednom.
- Šaljite ga kao
Authorization: Bearer cyv_live_…iliX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Ovlasti: config:read za konfiguraciju i lokacije, users:read za čitanje klijenata te users:write za stvaranje klijenata i upravljanje pretplatama.
Javni ugovor
Javna Postman kolekcija sadrži sve endpointe, parametre, tijela, primjere, ovlasti i kodove pogrešaka. Generira se iz backend ugovora i jedina je tehnička referenca.
Ograničenja: 120 zahtjeva u minuti po ključu i 10 u minuti za GET /users. grant, rotate i DELETE zahtijevaju Idempotency-Key; za ponovne pokušaje istog događaja koristite istu vrijednost 24 sata.
Vraćanje iz sigurnosne kopije
Dva načina da vratite svoje korisnike: vraćanje jednim klikom iz nadzorne ploče koje ih idempotentno ponovno uvozi, ili ručno vraćanje u prazan Marzban jer je datoteka u izvornom Marzban formatu korisnika.
Pristup u nuždi
Rezervni način povezivanja kada mreža koristi popise dopuštenih usluga, a glavna je veza blokirana — napravite videopoziv, predajte nam njegovu poveznicu iz svojeg računa ili e-poštom i dobijete gotovu vezu.