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

دليل

رمز API للسحابة

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

تشرح هذه الصفحة كيفية إنشاء رمز API لـ Hetzner Cloud من وحدة تحكم Hetzner Cloud، وكيفية حفظه في WHMCS ليتمكن الملحق من إدارة الخوادم نيابةً عنك. وهي موجهة لمديري WHMCS الذين يُعدّون Hetzner Cloud لأول مرة.

القائمة: الملحقات → Hetzner Data Center Core → Cloud → API Token

صفحة رمز API للسحابة

الغرض

تحفظ صفحة رمز API للسحابة رمز API لمشروع Hetzner Cloud المستخدم في جميع صفحات إدارة السحابة — Import Server وCloud Servers وConfigurable Options وISO Settings — بالإضافة إلى موديول السيرفر srv_hetzner_cloud لعمليات الإنشاء وإدارة دورة الحياة.

الخطوة 1 — إنشاء رمز في وحدة تحكم Hetzner Cloud

  1. سجّل الدخول إلى وحدة تحكم Hetzner Cloud.
  2. افتح المشروع الذي تريد ربطه بـ WHMCS.
  3. في القائمة اليسرى، اضغط Security.
  4. افتح تبويب API tokens.
  5. اضغط Generate API token.
  6. أدخل وصفاً (مثلاً "WHMCS production").
  7. اختر صلاحية الرمز:
    • Read — يسمح بطلبات GET فقط (للمراقبة/الجرد فقط).
    • Read & Write — يسمح بطلبات GET وPOST وPUT وDELETE.
  8. اضغط Generate API token.

Warning

يُعرض الرمز مرة واحدة فقط. انسخه واحفظه بأمان فوراً — لا يمكن لوحدة تحكم Hetzner Cloud عرضه مرة أخرى بعد إغلاق نافذة الحوار. إذا فقدته، أنشئ رمزاً جديداً وألغِ الرمز القديم.

Tip

يحتاج الملحق إلى رمز Read & Write. فهو ينشئ ويغيّر حجم ويعيد بناء ويحذف موارد Hetzner نيابةً عن طلبات WHMCS، لذا فإن رمز القراءة فقط سيؤدي إلى فشل إنشاء الطلبات ومعظم إجراءات منطقة العميل.

الخطوة 2 — حفظ الرمز في WHMCS

  1. في WHMCS، انتقل إلى الملحقات → Hetzner Data Center Core → Cloud → API Token.
  2. الصق الرمز في حقل Project API token.
  3. اضغط Check Token للتحقق منه عبر واجهة Hetzner Cloud API — يجب أن تظهر رسالة تؤكد قبول الرمز، مع عدد الخوادم الموجودة في المشروع.
  4. اضغط Save Token.

يعرض مؤشر Status في هذه الصفحة Configured (أخضر) بعد حفظ الرمز، أو Not configured (أحمر) إن لم يُحفظ.

الحقول والإجراءات

الاسم الودي الاسم النظامي النوع الافتراضي
Project API token cloud.api_token كلمة مرور (مشفّرة) —
مؤشر الحالة — عرض فقط Not configured
العنصر الوصف
Project API token حقل كلمة مرور — يُلصق فيه الرمز للحفظ أو الفحص؛ لا يُعرض مسبقاً بعد الحفظ
Check Token يستدعي واجهة Hetzner Cloud API (GET /servers) بالقيمة المُدخلة أو الرمز المحفوظ، ويعرض عدد الخوادم أو رسالة خطأ
Save Token يحفظ الرمز مشفّراً في إعدادات الملحق (cloud.api_token)

ملاحظات أمنية

Caution

لا تلصق رموز API أبداً في تذاكر الدعم أو لقطات الشاشة أو التوثيق. احجب الرموز قبل مشاركة أي لقطة شاشة.

  • يُخزَّن الرمز مشفّراً في مخزن إعدادات الملحق ولا يُحفظ أبداً كنص عادي.
  • لا يُعاد عرض الرمز في محتوى الصفحة بعد الحفظ.
  • استخدم رمزاً مخصصاً لمشروع Hetzner Cloud واحد — كل سجل سيرفر في WHMCS يقابل مشروعاً واحداً.

استكشاف الأخطاء

المشكلة الحل
جميع صفحات السحابة تعرض رسالة "configure token first" احفظ رمزاً صالحاً في هذه الصفحة
ظهور 401 Unauthorized عند الضغط على Check Token تم إلغاء الرمز أو كُتب بشكل خاطئ؛ أنشئ رمز Read & Write جديداً من وحدة تحكم Hetzner Cloud
نجاح Check Token لكن قائمة Import Server فارغة تحقق من أن المشروع يحتوي فعلياً على أنواع خوادم ومواقع متاحة لحسابك

المراجع

ذات صلة