Partner-API
Server-API för partner: skapa kunder, tilldela abonnemang och hantera dem från din egen webbplats eller bot.
Partner-API:t låter dig bygga en egen webbplats, kundportal eller bot ovanpå CreateYourVPN. Endast kunder, planer och abonnemang exponeras; servrar, noder, paneler och infrastrukturuppgifter visas aldrig i svaren.
Nyckeln är endast avsedd för server-till-server-anrop. Lägg den aldrig i JavaScript eller en mobilapp. Förfrågningar som ser ut att komma från en webbläsare avvisas med 403 browser_forbidden.
Kom igång
- Öppna Inställningar → API och integrationer i kontrollpanelen.
- Skapa en nyckel med minsta nödvändiga behörighet och kopiera hemligheten; den visas bara en gång.
- Skicka 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>"Behörigheter: config:read för konfiguration och platser, users:read för att läsa kunder samt users:write för att skapa kunder och hantera abonnemang.
Offentligt kontrakt
Den offentliga Postman-samlingen innehåller alla endpoints, parametrar, bodies, exempel, behörigheter och felkoder. Den genereras från backend-kontraktet och är därför den enda tekniska referensen.
Gränser: 120 förfrågningar per minut och nyckel, och 10 per minut för GET /users. grant, rotate och DELETE kräver en Idempotency-Key; återanvänd samma värde i 24 timmar för alla försök för samma händelse.
Återställ från en säkerhetskopia
Två sätt att få tillbaka dina användare: ettklicksåterställningen i panelen som importerar dem idempotent, eller en manuell återställning till ett tomt Marzban eftersom filen är i Marzbans egna användarformat.
Nödåtkomst
Ett reservsätt att ansluta när ett nätverk använder tillåtelselistor och den vanliga anslutningen är blockerad — skapa ett videosamtal, ge oss dess länk från ditt konto eller via e-post och få en färdig anslutning.