API Mitra
API server untuk mitra: buat pelanggan, berikan paket, dan kelola langganan dari situs atau bot Anda sendiri.
API Mitra memungkinkan Anda membangun situs, portal pelanggan, atau bot sendiri di atas CreateYourVPN. API hanya menampilkan pelanggan, paket, dan langganan; server, node, panel, serta kredensial infrastruktur tidak pernah muncul dalam respons.
Kunci hanya untuk komunikasi server-ke-server. Jangan pernah menaruhnya di JavaScript atau aplikasi seluler. Permintaan yang terlihat berasal dari browser ditolak dengan 403 browser_forbidden.
Memulai
- Buka Pengaturan → API dan integrasi di dasbor.
- Buat kunci dengan izin minimum dan salin rahasianya; nilai ini hanya ditampilkan sekali.
- Kirim 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>"Izin: config:read untuk konfigurasi dan lokasi, users:read untuk membaca pelanggan, serta users:write untuk membuat pelanggan dan mengelola langganan.
Kontrak publik
Koleksi Postman publik berisi semua endpoint, parameter, body, contoh, izin, dan kode kesalahan. Koleksi dibuat dari kontrak backend sehingga menjadi satu-satunya referensi teknis.
Batas: 120 permintaan per menit per kunci dan 10 per menit untuk GET /users. grant, rotate, dan DELETE memerlukan Idempotency-Key; gunakan nilai yang sama selama 24 jam untuk semua percobaan ulang dari peristiwa yang sama.
Pulihkan dari cadangan
Dua cara mengembalikan pengguna Anda: pemulihan sekali klik di dasbor yang mengimpornya ulang secara idempoten, atau pemulihan manual ke Marzban kosong karena berkasnya berformat pengguna Marzban asli.
Akses darurat
Cara cadangan untuk terhubung ketika jaringan memakai daftar izin dan koneksi utama diblokir — buat panggilan video, serahkan tautannya kepada kami dari akun Anda atau lewat email, lalu dapatkan koneksi siap pakai.