Partner-API
Server-API voor partners: maak klanten aan, ken abonnementen toe en beheer subscriptions vanuit je eigen site of bot.
Met de Partner-API bouw je een eigen website, klantenportaal of bot bovenop CreateYourVPN. Alleen klanten, abonnementen en subscriptions worden blootgesteld; servers, nodes, panels en infrastructuurgegevens verschijnen nooit in reacties.
De sleutel is uitsluitend server-to-server. Plaats hem nooit in JavaScript of een mobiele app. Verzoeken die uit een browser lijken te komen worden geweigerd met 403 browser_forbidden.
Aan de slag
- Open Instellingen → API en integraties in het dashboard.
- Maak een sleutel met minimale rechten en kopieer het geheim; dit wordt maar één keer getoond.
- Verstuur hem als
Authorization: Bearer cyv_live_…ofX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Beschikbare rechten: config:read voor configuratie en locaties, users:read om klanten te lezen en users:write om klanten aan te maken en subscriptions te beheren.
Openbaar contract
De openbare Postman-collectie bevat alle endpoints, parameters, bodies, voorbeelden, rechten en foutcodes. Ze wordt uit het backendcontract gegenereerd en is daarom de enige technische referentie.
Limieten: 120 verzoeken per minuut per sleutel en 10 per minuut voor GET /users. grant, rotate en DELETE vereisen een Idempotency-Key; hergebruik 24 uur lang dezelfde waarde voor alle pogingen van dezelfde gebeurtenis.
Herstellen vanuit een back-up
Twee manieren om uw gebruikers terug te halen: het herstel met één klik in het dashboard dat ze idempotent opnieuw importeert, of een handmatig herstel naar een kale Marzban omdat het bestand het native Marzban-gebruikersformaat is.
Noodtoegang
Een reservemanier om verbinding te maken wanneer een netwerk toelatingslijsten gebruikt en de gewone verbinding geblokkeerd is — maak een videogesprek aan, geef ons de link ervan vanuit je account of per e-mail, en krijg een kant-en-klare verbinding.