पार्टनर API
पार्टनरों के लिए सर्वर API: ग्राहक बनाएँ, प्लान दें और अपनी वेबसाइट या बॉट से सब्सक्रिप्शन प्रबंधित करें।
पार्टनर API से आप CreateYourVPN पर अपनी वेबसाइट, ग्राहक पोर्टल या बॉट बना सकते हैं। API केवल ग्राहकों, प्लान और सब्सक्रिप्शन को उपलब्ध कराता है; सर्वर, नोड, पैनल और इंफ्रास्ट्रक्चर क्रेडेंशियल किसी उत्तर में दिखाई नहीं देते।
कुंजी केवल सर्वर-से-सर्वर उपयोग के लिए है। एपीआई कुंजियाँ सर्वर पर संग्रहीत होती हैं और ब्राउज़र या मोबाइल एप्लिकेशन कोड में शामिल नहीं होती हैं। ब्राउज़र से भेजे गए अनुरोध HTTP 403 लौटाते हैं (browser_forbidden)।
शुरुआत
- डैशबोर्ड में सेटिंग्स → API और इंटीग्रेशन खोलें।
- न्यूनतम अनुमतियों वाली कुंजी बनाएँ और secret कॉपी करें; यह केवल एक बार दिखता है।
- कुंजी को
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 कलेक्शन में सभी endpoint, पैरामीटर, body, उदाहरण, अनुमतियाँ और त्रुटि कोड हैं। यह backend कॉन्ट्रैक्ट से बनता है और एकमात्र तकनीकी संदर्भ है।
सीमाएँ: हर कुंजी के लिए 120 अनुरोध प्रति मिनट और GET /users के लिए 10 प्रति मिनट। grant, rotate और DELETE में Idempotency-Key आवश्यक है; एक ही घटना के सभी retry में 24 घंटे तक वही मान उपयोग करें।
किसी बैकअप से पुनर्स्थापित करें
अपने उपयोगकर्ताओं को वापस लाने के दो तरीक़े: एक-क्लिक डैशबोर्ड restore जो उन्हें idempotently दोबारा इंपोर्ट करता है, या किसी खाली Marzban में मैन्युअल restore, क्योंकि फ़ाइल native Marzban user फ़ॉर्मैट में है।
आपातकालीन एक्सेस
जब नेटवर्क अनुमति-सूची पर चलता हो और मुख्य कनेक्शन ब्लॉक हो, तब जुड़ने का एक बैकअप तरीका — वीडियो कॉल बनाएँ, उसका लिंक हमें अपने कैबिनेट से या email से भेजें, और तैयार कनेक्शन पाएँ।