Partner-API
Server-API for partnere: opprett kunder, tildel abonnementer og administrer dem fra ditt eget nettsted eller din bot.
Partner-API-et lar deg bygge ditt eget nettsted, kundeområde eller en bot oppå CreateYourVPN. Bare kunder, planer og abonnementer eksponeres; servere, noder, paneler og infrastrukturlegitimasjon vises aldri i svarene.
Nøkkelen er bare for server-til-server-bruk. Ikke legg den i JavaScript eller en mobilapp. Forespørsler som ser ut til å komme fra en nettleser, avvises med 403 browser_forbidden.
Kom i gang
- Åpne Innstillinger → API og integrasjoner i kontrollpanelet.
- Opprett en nøkkel med minst mulige rettigheter, og kopier hemmeligheten; den vises bare é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>"Rettigheter: config:read for konfigurasjon og lokasjoner, users:read for å lese kunder og users:write for å opprette kunder og administrere abonnementer.
Offentlig kontrakt
Den offentlige Postman-samlingen inneholder alle endepunkter, parametere, request bodies, eksempler, rettigheter og feilkoder. Den genereres fra backend-kontrakten og er derfor den eneste tekniske referansen.
Grenser: 120 forespørsler per minutt per nøkkel og 10 per minutt for GET /users. grant, rotate og DELETE krever en Idempotency-Key; bruk samme verdi i 24 timer for alle forsøk på den samme hendelsen.
Gjenopprett fra en sikkerhetskopi
To måter å få brukerne dine tilbake på: gjenoppretting med ett klikk i dashbordet som importerer dem idempotent på nytt, eller en manuell gjenoppretting inn i en tom Marzban siden filen er i Marzbans eget brukerformat.
Nødtilgang
En reserveløsning for å koble til når nettverket bruker tillatelseslister og den vanlige forbindelsen er blokkert — opprett en videosamtale, gi oss lenken fra panelet ditt eller på e-post, og få en ferdig tilkobling.