API per a socis
API de servidor per a socis: crea clients, assigna plans i gestiona subscripcions des del teu web o bot.
L’API per a socis et permet crear el teu propi web, tauler de client o bot sobre CreateYourVPN. Només exposa clients, plans i subscripcions; els servidors, nodes, panells i credencials d’infraestructura no apareixen mai a les respostes.
La clau és només per a comunicacions servidor a servidor. No la posis en JavaScript ni en una aplicació mòbil. Les peticions que semblen provenir d’un navegador es rebutgen amb 403 browser_forbidden.
Primers passos
- Obre Configuració → API i integracions al tauler.
- Crea una clau amb els permisos mínims i copia’n el secret; només es mostra una vegada.
- Envia-la com
Authorization: Bearer cyv_live_…oX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Permisos: config:read per a configuració i ubicacions, users:read per consultar clients i users:write per crear clients i gestionar subscripcions.
Contracte públic
La col·lecció pública de Postman conté tots els endpoints, paràmetres, cossos, exemples, permisos i codis d’error. Es genera a partir del contracte del backend i és l’única referència tècnica.
Límits: 120 peticions per minut i clau, i 10 per minut per a GET /users. grant, rotate i DELETE requereixen un Idempotency-Key; reutilitza el mateix valor durant 24 hores per als reintents del mateix esdeveniment.
Restaura des d'una còpia de seguretat
Dues maneres de recuperar els teus usuaris: la restauració amb un sol clic del tauler que els reimporta de manera idempotent, o una restauració manual a un Marzban buit, ja que el fitxer té el format d'usuari natiu de Marzban.
Accés d'emergència
Una manera alternativa de connectar-te quan una xarxa fa servir llistes blanques i la connexió principal està bloquejada: crea una videotrucada, dona'ns-en l'enllaç des del teu compte o per correu i obtén una connexió a punt.