دليل
صناديق التخزين — توكن API
توضّح هذه الصفحة كيفية توليد توكن Hetzner API وحفظه في WHMCS لتتمكن الإضافة من إدارة صناديق التخزين نيابةً عنك. الصفحة موجّهة لمسؤولي WHMCS أثناء الإعداد الأول.
لماذا التوكن مطلوب
تُدار صناديق التخزين عبر واجهة Hetzner API الرسمية (https://api.hetzner.com/v1) باستخدام مصادقة Bearer. كل طلب تنفّذه الإضافة لأجل صناديق التخزين — تهيئة، سرد، إنشاء حسابات فرعية، إعادة تعيين كلمات مرور، قراءة الاستخدام — يُصادَق باستخدام هذا التوكن. من دون توكن صالح، لن تتمكن قائمة Storage Box الفرعية من الوصول إلى Hetzner وستفشل عمليات طلب المنتجات.
Note
هذا هو نفس عائلة التوكن المستخدمة في Hetzner Cloud، ويُولَّد من نفس شاشة Security ← API tokens في لوحة Hetzner Cloud Console — وهو ليس بيانات اعتماد خدمة الويب Robot المستخدمة للخوادم المخصصة.
الخطوة 1 — توليد التوكن من Hetzner Cloud Console
- سجّل الدخول إلى Hetzner Cloud Console.
- افتح Security من القائمة الجانبية.
- اختر تبويب API tokens.
- اضغط Generate API token.
- أدخل وصفاً واضحاً (مثلاً "WHMCS Storage Box").
- اختر صلاحية Read & Write.
- انسخ التوكن فوراً — يُعرض مرة واحدة فقط ولا يمكن استرجاعه لاحقاً.
Warning
إذا فقدت التوكن، عليك توليد توكن جديد وتحديثه في WHMCS. لا تعرض Hetzner التوكنات الموجودة مرة أخرى بعد إنشائها.
Tip
استخدم توكناً بصلاحية Read & Write لموديول صناديق التخزين. التوكن بصلاحية Read فقط يسمح للإضافة بسرد الصناديق لكن يفشل في أي إجراء تهيئة أو إدارة (إنشاء حساب فرعي، إعادة تعيين كلمة مرور، قفل/إلغاء قفل).
الخطوة 2 — حفظ التوكن في WHMCS
- انتقل إلى الإضافات (Addons) ← Hetzner Data Center Core ← Storage Box ← API Token.
- الصق التوكن في حقل API Token.
- اضغط حفظ، ثم استخدم إجراء اختبار الاتصال (Test Connection) الموجود في الصفحة للتأكد من قدرة WHMCS على الوصول إلى
https://api.hetzner.com/v1.
| الاسم الودّي | الاسم النظامي | النوع | الافتراضي |
|---|---|---|---|
| توكن API لصناديق التخزين | storagebox_api_token |
password | — |

Caution
يمنح التوكن صلاحية قراءة/كتابة كاملة على صناديق التخزين الخاصة بك. لا يُخزَّن بصيغة نصية واضحة أبداً، ويجب ألا يُشارَك في تذاكر الدعم أو السجلات أو لقطات الشاشة.
استكشاف الأخطاء وإصلاحها
| المشكلة | الحل |
|---|---|
| فشل اختبار الاتصال | تأكد من نسخ التوكن كاملاً وعدم انتهاء صلاحيته أو إلغائه من Hetzner Cloud Console |
| نجاح التهيئة لكن فشل إجراءات الإدارة | أعد توليد التوكن بصلاحية Read & Write بدلاً من Read فقط |
| صفحة Import Types لا تعرض أي خطط | أكمل هذه الصفحة أولاً، ثم راجع استيراد الأنواع |
المراجع
- توليد توكن API — وثائق Hetzner Cloud API
- وثائق منتج Storage Box
- إنشاء صندوق تخزين — دليل لوحة Hetzner
الخطوة التالية
انتقل إلى استيراد الأنواع لجلب خطط صناديق تخزين Hetzner إلى WHMCS كمنتجات قابلة للبيع.