API συνεργατών
Server API για συνεργάτες: δημιουργήστε πελάτες, εκχωρήστε πακέτα και διαχειριστείτε συνδρομές από τον ιστότοπο ή το bot σας.
Το API συνεργατών σάς επιτρέπει να δημιουργήσετε τον δικό σας ιστότοπο, πίνακα πελατών ή bot πάνω στο CreateYourVPN. Εκθέτει μόνο πελάτες, πακέτα και συνδρομές· διακομιστές, κόμβοι, panels και διαπιστευτήρια υποδομής δεν εμφανίζονται ποτέ στις απαντήσεις.
Το κλειδί προορίζεται μόνο για επικοινωνία server-to-server. Μην το τοποθετείτε σε JavaScript ή εφαρμογή για κινητά. Αιτήματα που μοιάζουν να προέρχονται από browser απορρίπτονται με 403 browser_forbidden.
Ξεκινώντας
- Ανοίξτε Ρυθμίσεις → API και ενσωματώσεις στον πίνακα.
- Δημιουργήστε κλειδί με τα ελάχιστα δικαιώματα και αντιγράψτε το μυστικό· εμφανίζεται μόνο μία φορά.
- Στείλτε το ως
Authorization: Bearer cyv_live_…ήX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Δικαιώματα: config:read για ρυθμίσεις και τοποθεσίες, users:read για ανάγνωση πελατών και users:write για δημιουργία πελατών και διαχείριση συνδρομών.
Δημόσιο συμβόλαιο
Η δημόσια συλλογή Postman περιέχει όλα τα endpoints, τις παραμέτρους, τα σώματα, τα παραδείγματα, τα δικαιώματα και τους κωδικούς σφαλμάτων. Παράγεται από το συμβόλαιο του backend και είναι η μοναδική τεχνική αναφορά.
Άνοιγμα της δημόσιας συλλογής Postman
Εξερευνήστε το API και αντιγράψτε τη συλλογή στο workspace σας.
Όρια: 120 αιτήματα ανά λεπτό ανά κλειδί και 10 ανά λεπτό για GET /users. Τα grant, rotate και DELETE απαιτούν Idempotency-Key· χρησιμοποιήστε την ίδια τιμή για 24 ώρες σε όλες τις επαναλήψεις του ίδιου συμβάντος.
Επαναφορά από αντίγραφο ασφαλείας
Δύο τρόποι για να επαναφέρετε τους χρήστες σας: η επαναφορά με ένα κλικ από τον πίνακα ελέγχου που τους επανεισάγει idempotent, ή μια χειροκίνητη επαναφορά σε ένα κενό Marzban, αφού το αρχείο είναι σε εγγενή μορφή χρηστών Marzban.
Πρόσβαση έκτακτης ανάγκης
Ένας εφεδρικός τρόπος σύνδεσης όταν το δίκτυο χρησιμοποιεί λίστες επιτρεπόμενων και η κύρια σύνδεση είναι φραγμένη — δημιουργείτε μια βιντεοκλήση, μας δίνετε τον σύνδεσμό της από τον λογαριασμό σας ή με email και παίρνετε έτοιμη σύνδεση.