Kumppani-API
Palvelin-API kumppaneille: luo asiakkaita, myönnä paketteja ja hallitse tilauksia omalta sivustoltasi tai botistasi.
Kumppani-API:n avulla voit rakentaa oman sivuston, asiakasportaalin tai botin CreateYourVPN:n päälle. API näyttää vain asiakkaat, paketit ja tilaukset; palvelimet, solmut, hallintapaneelit ja infrastruktuurin tunnukset eivät koskaan sisälly vastauksiin.
Avain on tarkoitettu vain palvelinten väliseen käyttöön. Älä koskaan sijoita sitä JavaScriptiin tai mobiilisovellukseen. Selaimesta tulevilta näyttävät pyynnöt hylätään virheellä 403 browser_forbidden.
Aloittaminen
- Avaa hallintapaneelissa Asetukset → API ja integraatiot.
- Luo avain vähimmäisoikeuksilla ja kopioi salaisuus; se näytetään vain kerran.
- Lähetä avain otsikossa
Authorization: Bearer cyv_live_…taiX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Oikeudet: config:read asetuksia ja sijainteja varten, users:read asiakkaiden lukemiseen sekä users:write asiakkaiden luomiseen ja tilausten hallintaan.
Julkinen sopimus
Julkinen Postman-kokoelma sisältää kaikki endpointit, parametrit, rungot, esimerkit, oikeudet ja virhekoodit. Se luodaan backend-sopimuksesta ja on siksi ainoa tekninen lähde.
Rajat: 120 pyyntöä minuutissa avainta kohden ja 10 minuutissa GET /users -kutsulle. grant, rotate ja DELETE vaativat Idempotency-Key-otsikon; käytä saman tapahtuman uusintayrityksissä samaa arvoa 24 tunnin ajan.
Palauta varmuuskopiosta
Kaksi tapaa saada käyttäjäsi takaisin: yhden klikkauksen palautus hallintapaneelista, joka tuo heidät takaisin idempotentisti, tai manuaalinen palautus tyhjään Marzbaniin, koska tiedosto on natiivia Marzbanin käyttäjäformaattia.
Hätäyhteys
Varayhteystapa tilanteisiin, joissa verkossa on käytössä sallittujen lista ja tavallinen yhteys on estetty — luo videopuhelu, anna meille sen linkki tililtäsi tai sähköpostitse ja saat valmiin yhteyden.