تخطّ إلى المحتوى

دليل

صناديق التخزين — توكن API

دليل 3 دقائق قراءة

توضّح هذه الصفحة كيفية توليد توكن 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

  1. سجّل الدخول إلى Hetzner Cloud Console.
  2. افتح Security من القائمة الجانبية.
  3. اختر تبويب API tokens.
  4. اضغط Generate API token.
  5. أدخل وصفاً واضحاً (مثلاً "WHMCS Storage Box").
  6. اختر صلاحية Read & Write.
  7. انسخ التوكن فوراً — يُعرض مرة واحدة فقط ولا يمكن استرجاعه لاحقاً.

Warning

إذا فقدت التوكن، عليك توليد توكن جديد وتحديثه في WHMCS. لا تعرض Hetzner التوكنات الموجودة مرة أخرى بعد إنشائها.

Tip

استخدم توكناً بصلاحية Read & Write لموديول صناديق التخزين. التوكن بصلاحية Read فقط يسمح للإضافة بسرد الصناديق لكن يفشل في أي إجراء تهيئة أو إدارة (إنشاء حساب فرعي، إعادة تعيين كلمة مرور، قفل/إلغاء قفل).

الخطوة 2 — حفظ التوكن في WHMCS

  1. انتقل إلى الإضافات (Addons) ← Hetzner Data Center Core ← Storage Box ← API Token.
  2. الصق التوكن في حقل API Token.
  3. اضغط حفظ، ثم استخدم إجراء اختبار الاتصال (Test Connection) الموجود في الصفحة للتأكد من قدرة WHMCS على الوصول إلى https://api.hetzner.com/v1.
الاسم الودّي الاسم النظامي النوع الافتراضي
توكن API لصناديق التخزين storagebox_api_token password —

صفحة توكن API لصناديق التخزين

Caution

يمنح التوكن صلاحية قراءة/كتابة كاملة على صناديق التخزين الخاصة بك. لا يُخزَّن بصيغة نصية واضحة أبداً، ويجب ألا يُشارَك في تذاكر الدعم أو السجلات أو لقطات الشاشة.

استكشاف الأخطاء وإصلاحها

المشكلة الحل
فشل اختبار الاتصال تأكد من نسخ التوكن كاملاً وعدم انتهاء صلاحيته أو إلغائه من Hetzner Cloud Console
نجاح التهيئة لكن فشل إجراءات الإدارة أعد توليد التوكن بصلاحية Read & Write بدلاً من Read فقط
صفحة Import Types لا تعرض أي خطط أكمل هذه الصفحة أولاً، ثم راجع استيراد الأنواع

المراجع

الخطوة التالية

انتقل إلى استيراد الأنواع لجلب خطط صناديق تخزين Hetzner إلى WHMCS كمنتجات قابلة للبيع.