Partner-API
Server-API til partnere: opret kunder, tildel abonnementer, og administrer dem fra dit eget website eller din bot.
Partner-API'et gør det muligt at bygge dit eget website, kundeområde eller din egen bot oven på CreateYourVPN. Kun kunder, planer og abonnementer eksponeres; servere, noder, paneler og infrastrukturens legitimationsoplysninger vises aldrig i svar.
Nøglen er kun til server-til-server-brug. Læg den aldrig i JavaScript eller en mobilapp. Anmodninger, der ligner browsertrafik, afvises med 403 browser_forbidden.
Kom i gang
- Åbn Indstillinger → API og integrationer i kontrolpanelet.
- Opret en nøgle med færrest mulige rettigheder, og kopiér hemmeligheden; den vises kun én gang.
- Send den som
Authorization: Bearer cyv_live_…ellerX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Rettigheder: config:read til konfiguration og lokationer, users:read til at læse kunder og users:write til at oprette kunder og administrere abonnementer.
Offentlig kontrakt
Den offentlige Postman-samling indeholder alle endpoints, parametre, bodies, eksempler, rettigheder og fejlkoder. Den genereres fra backend-kontrakten og er derfor den eneste tekniske reference.
Grænser: 120 anmodninger pr. minut pr. nøgle og 10 pr. minut for GET /users. grant, rotate og DELETE kræver en Idempotency-Key; genbrug samme værdi i 24 timer ved forsøg for den samme hændelse.
Gendan fra en sikkerhedskopi
To måder at få dine brugere tilbage på: gendannelsen med ét klik i kontrolpanelet, der genimporterer dem idempotent, eller en manuel gendannelse ind i en tom Marzban, da filen er i Marzbans eget brugerformat.
Nødadgang
En reserveløsning til at forbinde, når et netværk bruger hvidlister, og den almindelige forbindelse er blokeret — opret et videoopkald, giv os linket fra din konto eller med e-mail, og få en klar forbindelse.