API pentru parteneri
API de server pentru parteneri: creează clienți, acordă planuri și gestionează abonamente din propriul site sau bot.
API-ul pentru parteneri îți permite să construiești propriul site, portal pentru clienți sau bot peste CreateYourVPN. Sunt expuși doar clienții, planurile și abonamentele; serverele, nodurile, panourile și credențialele infrastructurii nu apar niciodată în răspunsuri.
Cheia este destinată exclusiv comunicării server-la-server. Nu o include în JavaScript sau într-o aplicație mobilă. Cererile care par să provină din browser sunt respinse cu 403 browser_forbidden.
Primii pași
- Deschide Setări → API și integrări în panou.
- Creează o cheie cu permisiunile minime și copiază secretul; este afișat o singură dată.
- Trimite cheia ca
Authorization: Bearer cyv_live_…sauX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Permisiuni: config:read pentru configurare și locații, users:read pentru citirea clienților și users:write pentru crearea clienților și gestionarea abonamentelor.
Contract public
Colecția publică Postman conține toate endpointurile, parametrii, corpurile, exemplele, permisiunile și codurile de eroare. Este generată din contractul backend și reprezintă unica referință tehnică.
Limite: 120 de cereri pe minut pentru fiecare cheie și 10 pe minut pentru GET /users. grant, rotate și DELETE necesită Idempotency-Key; reutilizează aceeași valoare timp de 24 de ore pentru toate reîncercările aceluiași eveniment.
Restaurează dintr-o copie de rezervă
Două moduri de a-ți aduce utilizatorii înapoi: restaurarea cu un clic din dashboard, care îi reimportă idempotent, sau o restaurare manuală într-un Marzban gol, deoarece fișierul este în formatul nativ de utilizator Marzban.
Acces de urgență
O cale de rezervă pentru conectare atunci când rețeaua folosește liste de permisiuni, iar conexiunea principală este blocată — creezi un apel video, ne dai linkul lui din cont sau prin e-mail și primești o conexiune gata de folosit.