API Rakan Kongsi
API pelayan untuk rakan kongsi: cipta pelanggan, berikan pelan dan urus langganan daripada laman atau bot anda sendiri.
API Rakan Kongsi membolehkan anda membina laman, portal pelanggan atau bot sendiri di atas CreateYourVPN. Hanya pelanggan, pelan dan langganan didedahkan; pelayan, nod, panel dan kelayakan infrastruktur tidak pernah muncul dalam respons.
Kunci hanya untuk komunikasi pelayan-ke-pelayan. Jangan letakkannya dalam JavaScript atau aplikasi mudah alih. Permintaan yang kelihatan datang daripada pelayar ditolak dengan 403 browser_forbidden.
Bermula
- Buka Tetapan → API dan integrasi dalam papan pemuka.
- Cipta kunci dengan kebenaran minimum dan salin rahsianya; ia hanya dipaparkan sekali.
- Hantarnya sebagai
Authorization: Bearer cyv_live_…atauX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Kebenaran: config:read untuk konfigurasi dan lokasi, users:read untuk membaca pelanggan dan users:write untuk mencipta pelanggan serta mengurus langganan.
Kontrak awam
Koleksi Postman awam mengandungi semua endpoint, parameter, body, contoh, kebenaran dan kod ralat. Ia dijana daripada kontrak backend dan menjadi satu-satunya rujukan teknikal.
Had: 120 permintaan seminit bagi setiap kunci dan 10 seminit untuk GET /users. grant, rotate dan DELETE memerlukan Idempotency-Key; gunakan nilai yang sama selama 24 jam untuk semua cubaan semula bagi peristiwa yang sama.
Pulihkan daripada sandaran
Dua cara untuk mengembalikan pengguna anda: pemulihan papan pemuka sekali klik yang mengimportnya semula secara idempoten, atau pemulihan manual ke Marzban kosong kerana failnya dalam format pengguna Marzban asli.
Akses kecemasan
Cara sandaran untuk menyambung apabila rangkaian menggunakan senarai dibenarkan dan sambungan utama disekat — buat panggilan video, berikan pautannya kepada kami daripada panel anda atau melalui e-mel, dan dapatkan sambungan sedia guna.