API partner
API server per i partner: crea clienti, assegna piani e gestisci gli abbonamenti dal tuo sito o bot.
L’API partner ti consente di creare un sito, un’area clienti o un bot personalizzato su CreateYourVPN. Espone solo clienti, piani e abbonamenti; server, nodi, pannelli e credenziali infrastrutturali non compaiono mai nelle risposte.
La chiave è esclusivamente server-to-server. Non inserirla in JavaScript o in un’app mobile. Le richieste che sembrano provenire da un browser vengono rifiutate con 403 browser_forbidden.
Per iniziare
- Apri Impostazioni → API e integrazioni nella dashboard.
- Crea una chiave con i permessi minimi e copia il segreto; viene mostrato una sola volta.
- Invia la chiave come
Authorization: Bearer cyv_live_…oppureX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Permessi disponibili: config:read per configurazione e località, users:read per leggere i clienti e users:write per crearli e gestire i loro abbonamenti.
Contratto pubblico
La raccolta pubblica di Postman contiene tutti gli endpoint, i parametri, i body, gli esempi, i permessi e i codici di errore. È generata dal contratto backend ed è quindi l’unico riferimento tecnico.
Limiti: 120 richieste al minuto per chiave e 10 al minuto per GET /users. grant, rotate e DELETE richiedono un Idempotency-Key; riutilizza lo stesso valore per 24 ore in tutti i tentativi dello stesso evento.
Ripristina da un backup
Due modi per recuperare i tuoi utenti: il ripristino con un clic dalla dashboard che li reimporta in modo idempotente, oppure un ripristino manuale in un Marzban vuoto, dato che il file è nel formato utente nativo di Marzban.
Accesso di emergenza
Un modo di riserva per connettersi quando la rete usa liste di consentiti e la connessione principale è bloccata: crea una videochiamata, consegnaci il suo link dalla tua area personale o via email e ottieni una connessione pronta all'uso.