API para socios
API de servidor para socios: crea clientes, concede planes y gestiona suscripciones desde tu propio sitio o bot.
La API para socios permite crear tu propio sitio, panel o bot sobre CreateYourVPN. Solo expone clientes, planes y suscripciones; los servidores, nodos, paneles y credenciales de infraestructura nunca aparecen en las respuestas.
La clave es solo para comunicaciones entre servidores. No la incluyas en JavaScript ni en una aplicación móvil. Las solicitudes que parecen proceder de un navegador se rechazan con 403 browser_forbidden.
Primeros pasos
- Abre Configuración → API e integraciones en el panel.
- Crea una clave con los permisos mínimos y copia el secreto; solo se muestra una vez.
- Envía la clave como
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 disponibles: config:read para configuración y ubicaciones, users:read para consultar clientes y users:write para crear clientes y modificar sus suscripciones.
Contrato público
La colección pública de Postman contiene todos los endpoints, parámetros, cuerpos, ejemplos, permisos y códigos de error. Se genera a partir del contrato del backend, por lo que es la única referencia técnica.
Límites: 120 solicitudes por minuto por clave y 10 por minuto para GET /users. grant, rotate y DELETE requieren un Idempotency-Key; reutiliza la misma clave durante 24 horas para todos los reintentos del mismo evento.
Restaurar desde una copia de seguridad
Dos formas de recuperar a tus usuarios: la restauración con un clic desde el panel, que los reimporta de forma idempotente, o una restauración manual en un Marzban vacío, ya que el archivo está en formato de usuario nativo de Marzban.
Acceso de emergencia
Una forma de reserva para conectarte cuando la red usa listas blancas y la conexión principal está bloqueada: crea una videollamada, danos su enlace desde tu panel o por correo y obtén una conexión lista para usar.