واجهة API للشركاء
واجهة خادوم للشركاء: أنشئ العملاء وامنح الباقات وأدر الاشتراكات من موقعك أو روبوتك.
تتيح لك واجهة API للشركاء إنشاء موقعك أو بوابة عملائك أو روبوتك فوق CreateYourVPN. لا تعرض الواجهة سوى العملاء والباقات والاشتراكات؛ ولا تظهر الخوادم أو العُقد أو لوحات الإدارة أو بيانات اعتماد البنية التحتية في أي استجابة.
المفتاح مخصص للاتصال من خادوم إلى خادوم فقط. لا تضعه في JavaScript أو تطبيق جوال. تُرفض الطلبات التي تبدو قادمة من متصفح بالخطأ 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 العامة جميع نقاط النهاية والمعاملات والأجسام والأمثلة والصلاحيات ورموز الأخطاء. تُولَّد من عقد الواجهة الخلفية، ولذلك فهي المرجع التقني الوحيد.
الحدود: 120 طلبًا في الدقيقة لكل مفتاح، و10 طلبات في الدقيقة لـ GET /users. تتطلب grant وrotate وDELETE قيمة Idempotency-Key؛ أعد استخدام القيمة نفسها لمدة 24 ساعة في كل محاولات الحدث نفسه.
الاستعادة من نسخة احتياطية
طريقتان لاسترجاع مستخدميك: استعادة بنقرة واحدة من لوحة التحكم تعيد استيرادهم بشكل عديم الأثر التراكمي، أو استعادة يدوية إلى Marzban فارغ لأن الملف بصيغة مستخدمي Marzban الأصلية.
الوصول الطارئ
طريقة احتياطية للاتصال حين تعتمد الشبكة قوائم السماح ويكون اتصالك الأساسي محجوبًا — أنشئ مكالمة فيديو، وأعطنا رابطها من حسابك أو بالبريد الإلكتروني، واحصل على اتصال جاهز.