VPS API: أتمتة الخوادم السحابية عبر JSON REST
واجهة API للخوادم السحابية تدير بها كل شيء بالكود من الإنشاء حتى الحذف
- JSON REST API
- مصادقة بمفتاح API (Bearer)
- 300 طلب في الدقيقة
VPS API هي طريقة برمجية للقيام بالأعمال التي تقوم بها في لوحة التحكم، مثل إنشاء الخوادم وتشغيلها وإيقافها وحذفها، باستخدام طلبات HTTP. واجهة برمجة التطبيقات (API) لخوادم HELPER VPS السحابية مجانية لجميع الأعضاء؛ بعد أول دفعة لك، أنشئ مفتاح API وتواصل على الفور.
ماذا يمكنني أن أؤتمت عبر VPS API؟
تظهر قوة VPS API أكثر عندما تنشئ الخوادم وتحذفها كثيرًا أو تدير عدة خوادم دفعة واحدة. جمعنا أربع عمليات أتمتة شائعة الاستخدام.
إنشاء الخوادم في خط النشر
في خطوط النشر مثل GitLab CI أنشئ خادم اختبار بطلب POST /servers، واحذفه بطلب DELETE عند انتهاء الاختبار. يوجد الخادم فقط في اللحظة التي تحتاجه فيها، فتبقى التكاليف مرتبة.
التحقق من حالة الخوادم وإدارة التشغيل
اقرأ عبر GET /servers قائمة خوادمك وحالتها وعناوين IPv4 وIPv6 وتاريخ الفوترة التالي، وأدر التشغيل عند الحاجة بطلبات start وstop وreboot. ويمكنك أيضًا كتابة سكربت يربط أداة مراقبة ويعيد تشغيل الخادم المتوقف.
بيع الخوادم وتشغيلها داخل خدمتك
استدعِ API من لوحة إدارة صنعتها أو من روبوت لإنشاء الخوادم وعرض النتيجة. اقرأ من قائمة البيع GET /catalog الأحجام والمناطق وأنظمة التشغيل والخيارات المتاحة واعرضها في شاشتك كما هي.
إدارة تواريخ الفوترة والتجديد
تحقق من تاريخ الفوترة التالي لكل خادم باستخدام القيمة paid_until، وجدد على الفور باستخدام طلب renew للخوادم التي تريد الدفع لفترة أطول مقدمًا. تابع فواتيرك وتواريخ الفوترة في الكود للحفاظ على تشغيل الخوادم المهمة بشكل مستمر.
لوحة التحكم أم VPS API، متى أستخدم كلًا منهما؟
لوحة التحكم وAPI يعملان مع نفس الحساب ونفس الخوادم. لإدارة خادم أو اثنين يدويًا، تكون لوحة التحكم ملائمة؛ للأعمال المتكررة أو العديد من الخوادم، تكون API أسرع.
لوحة التحكم
إدارة بالنقر في الشاشة
مناسب لـ
- عند إنشاء خادم لأول مرة
- عند إدارة خادم أو اثنين بنفسك
- إعادة تثبيت نظام التشغيل وتسجيل مفاتيح SSH
- عند الرجوع إلى كلمة مرور root مرة أخرى
VPS API
إدارة بإرسال الطلبات من الكود
مناسب لـ
- بيئات الاختبار التي تُنشأ فيها الخوادم وتُحذف كثيرًا
- أتمتة خطوط النشر والسكربتات
- عند قراءة حالة عدة خوادم دفعة واحدة
- عند الربط بلوحة إدارة أو روبوت صنعته بنفسك
كيف أتصل بواجهة API للخوادم السحابية؟
يتطلب الأمر ثلاث خطوات. أولًا، قم بأول دفعة، وبمجرد تأكيدها، أنشئ مفتاحًا في صفحة مفاتيح API. بعد ذلك، ضع المفتاح في رأس Authorization لكل طلب باستخدام نظام Bearer. أخيرًا، أرسل الطلبات إلى المسار الذي تريده بعد العنوان الأساسي https://helpervps.com/api/v1، وستعود النتائج بتنسيق JSON.
من الجيد البدء باستدعاء GET /catalog. تعود دفعة واحدة أنواع الخوادم وأحجامها المتاحة حاليًا، ورموز المناطق، ورموز أنظمة التشغيل والتطبيقات بنقرة واحدة، وأسعار النسخ الاحتياطي التلقائي والقرص الإضافي والحماية من DDoS. ضع رموز plan وlocation وimage التي حصلت عليها هنا كما هي في طلب إنشاء الخادم.
لإنشاء خادم، أرسل قيم plan وlocation وimage وlabel بتنسيق JSON إلى POST /servers. يمكنك أيضًا تضمين معرف مفتاح SSH الذي أضفته وخيارات backups وextra_disk_gb وddos_protection. تدفع مقدمًا عن الفترة المختارة، وتحتوي الاستجابة على معرف الخادم والحالة وكلمة مرور root، لذا احفظها في مكان آمن على الفور.
ما الأعمال التي يمكن تنفيذها عبر VPS API؟
تغطي VPS API دورة حياة الخادم من البداية إلى النهاية. تقرأ قائمة البيع عبر GET /catalog، وتنشئ خادمًا عبر POST /servers، وتقرأ قائمة خوادمك عبر GET /servers، ومعلومات خادم واحد عبر GET /servers/{id}. وتتضمن الاستجابة اسم الخادم وحالته وعناوين IPv4 وIPv6 والرسوم الشهرية والخيارات المختارة وتاريخ الفوترة التالي.
التشغيل يتم بطلبات POST /servers/{id}/start وstop وreboot للتشغيل والإيقاف وإعادة التشغيل. وPOST /servers/{id}/renew يدفع رسوم شهر الآن ويجدد فورًا دون انتظار تاريخ الفوترة، وDELETE /servers/{id} يحذف الخادم. وإذا لم يتوافق الطلب مع الحالة الحالية للخادم يُبلغك برمز wrong_state، فيسهل على السكربت تحديد الخطوة التالية.
تعود الأخطاء بصيغة JSON تحتوي قيمة error مع رمز الحالة. الأسباب مقسّمة إلى رموز: unauthorized إذا لم يتطابق المفتاح، وnot_enough_balance إذا لم يكفِ الرصيد، وlimit إذا بلغ عدد الخوادم في الحساب الحد، وrate_limited إذا كثرت الطلبات، فيسهل التعامل مع كل حالة في البرنامج. القائمة الكاملة وأمثلة الاستجابات موجودة في توثيق API.
كم رسوم VPS API؟
واجهة برمجة التطبيقات (API) لـ VPS مجانية لجميع الأعضاء. الخوادم والخيارات التي تم إنشاؤها باستخدام API تُدفع بنفس أسعار الخوادم التي تم إنشاؤها في لوحة التحكم.
استخدام API مجاني
لا توجد رسوم لإصدار مفاتيح API أو إجراء الطلبات. أي عضو قام بأول دفعة يمكنه إنشاء مفتاح واستخدامه على الفور.
300 طلب في الدقيقة
ترسل حتى 300 طلب في الدقيقة بمفتاح واحد. حد وافر للأتمتة اليومية مثل التحقق من قائمة الخوادم وإدارة التشغيل.
السعر نفسه كما في لوحة التحكم
الخوادم التي تم إنشاؤها باستخدام API لها نفس الأسعار المدرجة في قائمة الأسعار، وتُضاف الخيارات بنفس المبالغ، وتجدد في كل تاريخ فوترة.
HELPER VPS بالأرقام
اختر من 40 منطقة و12 نظام تشغيل و10 تطبيقًا بنقرة واحدة في حساب واحد، وادفع على الفور. الأرقام أدناه مبنية على ما هو معروض للبيع الآن.
40
منطقة مركز البيانات
12
نظام التشغيل
10
تطبيقات بنقرة واحدة
مجاني
السعر الابتدائي لهذا المنتج (شهريًا)
أدوات أتمتة تعمل مع VPS API
أي أداة تستطيع إرسال طلبات HTTP تتصل بـ VPS API. من سطر curl واحد إلى سكربتات Python وNode.js وخطوط النشر، تستخدمها كلها بالطريقة نفسها.
- Terraform
- Python
- Node.js
- GitLab CI
- Docker
لماذا تختار API من HELPER VPS
JSON REST بسيطة
ترسل الطلبات وتستقبل الاستجابات بطرق HTTP المألوفة وJSON. وتختبر فورًا حتى بـ curl دون مكتبات إضافية.
مصادقة بمفتاح API (Bearer)
تضع مفتاحًا واحدًا في ترويسة Authorization، فتتم المصادقة بالطريقة نفسها في أي لغة وأي أداة.
300 طلب في الدقيقة
ترسل حتى 300 طلب في الدقيقة بمفتاح واحد، فتتعامل براحة مع التحقق من حالة عدة خوادم وإدارة تشغيلها.
قائمة البيع بالكود
اقرأ عبر GET /catalog الأحجام والمناطق وأنظمة التشغيل وأسعار الخيارات واستخدمها كما هي في شاشتك وسكربتاتك.
من الإنشاء حتى الحذف
نفّذ عبر API كل شيء: إنشاء الخوادم وعرض القائمة والتشغيل والإيقاف وإعادة التشغيل والتجديد والحذف.
اختيار الخيارات معًا
عند إنشاء الخادم أضف النسخ الاحتياطي التلقائي والقرص الإضافي والحماية من DDoS ومفتاح SSH في طلب واحد.
رموز أخطاء تُظهر السبب
أسباب الأخطاء مقسمة إلى رموز، مثل عدم كفاية رصيد الحساب، وحد الخادم، وعدم تطابق الحالة، مما يسهل التعامل معها في برنامجك.
الحساب نفسه في لوحة التحكم
الخوادم التي تم إنشاؤها باستخدام API تظهر في لوحة التحكم كما هي، وتُدفع وتجدد بنفس الطريقة.
مجاني لجميع الأعضاء
بمجرد قيامك بأول دفعة، أنشئ مفتاح API دون رسوم وابدأ الأتمتة على الفور.
الأسئلة الشائعة حول VPS API
إجابات عن الاتصال بـ VPS API والمصادقة وحدود الطلبات
هل VPS API مجانية؟
نعم، واجهة برمجة التطبيقات (API) لـ VPS مجانية لجميع الأعضاء. إصدار مفاتيح API وإجراء الطلبات مجاني، والخوادم والخيارات التي تم إنشاؤها باستخدام API تُدفع بنفس أسعار تلك التي تم إنشاؤها في لوحة التحكم. أي عضو قام بأول دفعة يمكنه إنشاء مفتاح على الفور في صفحة مفاتيح API.
أين أنشئ مفتاح API؟
بمجرد قيامك بأول دفعة، تفتح صفحة مفاتيح API (/api-key) وتنشئ المفاتيح هناك. ضع المفتاح في رأس Authorization لكل طلب باستخدام نظام Bearer. المفتاح يفتح حسابك بالكامل، لذا لا تقم بإضافته إلى مستودعات الكود؛ احتفظ به في متغيرات البيئة أو مخزن الأسرار.
ما الأعمال التي يمكنني تنفيذها عبر API؟
يمكنك قراءة قائمة البيع (GET /catalog)، وقراءة قائمة الخوادم ومعلومات خادم واحد (GET /servers وGET /servers/{id})، وإنشاء خادم (POST /servers)، والتشغيل والإيقاف وإعادة التشغيل (start وstop وreboot)، والتجديد لشهر (renew)، والحذف (DELETE /servers/{id}). أمثلة الطلبات وصيغة الاستجابة موجودة في توثيق API.
ما حد الطلبات؟
ترسل حتى 300 طلب في الدقيقة بمفتاح واحد. عند تجاوز الحد يعود رمز الحالة 429 مع خطأ rate_limited، فاجعل السكربت ينتظر قليلًا ثم يعيد الإرسال. وتعمل الأتمتة اليومية مثل التحقق من قائمة الخوادم وإدارة التشغيل براحة ضمن هذا الحد. ولا توجد رسوم حسب عدد الطلبات.
كيف تُخصم الرسوم عند إنشاء خادم عبر API؟
عند نجاح طلب POST /servers، تتم معالجة الدفع عن فترة الفوترة المختارة ويتم إنشاء الخادم. يتم استرداد الدفع للخادم الذي فشل إنشاؤه إلى رصيد حسابك.
كيف أحصل على كلمة مرور root عبر API؟
تأتي قيمة root_password مرة واحدة في استجابة طلب إنشاء الخادم. احفظها في مكان آمن فور استلام الاستجابة. ويمكنك رؤيتها مجددًا في لوحة التحكم لمدة 7 أيام، وإذا أرسلت رقم مفتاح SSH مع الطلب تتصل فورًا بالمفتاح دون كلمة مرور. ويمكنك بدء اتصال SSH فورًا بقيمة ipv4 في الاستجابة، فيسهل ربط ذلك بسكربتات النشر.
هل يمكنني إضافة مفتاح SSH عبر API؟
نعم، إذا وضعت رقم مفتاح SSH المسجّل كقيمة ssh_key_id في طلب إنشاء الخادم يُضاف ذلك المفتاح إلى الخادم الجديد. يكفي تسجيل المفتاح مرة واحدة من شاشة مفاتيح SSH في لوحة التحكم، وتُعرض البصمة بالطريقة نفسها التي يستخدمها ssh-keygen فتعرف المفتاح فورًا. حدّد رقم المفتاح مرة واحدة وأعد استخدامه.
بأي لغة أو أداة يمكنني استخدامها؟
أي لغة أو أداة تستطيع إرسال طلبات HTTP تصلح. اختبر فورًا بـ curl، واستدعِ العنوان والترويسة نفسيهما من requests في Python، وfetch في Node.js، وخطوة السكربت في GitLab CI، وميزة طلبات HTTP في Terraform. وجميع الاستجابات بصيغة JSON فيسهل قراءة النتائج.
كيف أعرف حدوث خطأ؟
تعود الأخطاء برمز حالة غير 2xx مع JSON يحتوي قيمة error. الأسباب مقسّمة: unauthorized إذا كان المفتاح خاطئًا، وbad_request إذا نقصت قيمة، وnot_enough_balance إذا لم يكفِ الرصيد، وwrong_state إذا لم يتوافق الطلب مع حالة الخادم، فتتعامل مع كل حالة في البرنامج.
هل تظهر الخوادم المنشأة عبر API في لوحة التحكم؟
نعم، واجهة API ولوحة التحكم تتعاملان مع الحساب نفسه والخوادم نفسها. الخوادم المنشأة عبر API تظهر كما هي في قائمة لوحة التحكم، ومن لوحة التحكم يمكنك إعادة تثبيت نظام التشغيل أو التحقق من كلمة المرور. وينطبق حد 10 خوادم لكل حساب على الطريقتين معًا. وحتى لو مزجت بين العمل اليدوي والعمل بالكود تظهر الحالة وتواريخ الفوترة متطابقة دائمًا.
أدلة VPS API
إرشادات يُستحسن قراءتها عند الاتصال بواجهة API لأول مرة
- توثيق APIالعنوان الأساسي وترويسة المصادقة وأمثلة الطلبات لكل مسار وصيغة الاستجابة والقائمة الكاملة لرموز الأخطاء.
- إنشاء مفتاح SSH وتسجيلهطريقة إنشاء مفتاح SSH وتسجيله لتتصل فورًا بالمفتاح بالخوادم المنشأة عبر API.
- الأسعار في لمحةقارن في صفحة واحدة الرسوم الشهرية لأحجام الخوادم والخيارات التي يمكنك اختيارها عبر API.
واجهة برمجة التطبيقات (API) لـ VPS مجانية لجميع الأعضاء، ويمكنك إنشاء مفتاح API بعد قيامك بأول دفعة. الخوادم والخيارات التي تم إنشاؤها باستخدام API تُدفع بنفس الأسعار المدرجة في قائمة الأسعار وتجدد تلقائيًا بنفس المبلغ في كل تاريخ فوترة.
حد الطلبات: 300 في الدقيقة لكل مفتاح API | 10 خوادم لكل حساب | إذا فشل الدفع: يتم تعليق الخادم، ثم يتم حذفه بعد 3 أيام | لا يتم استرداد الوقت المتبقي على الخوادم المحذوفة. يتم استرداد المبالغ إلى رصيد حسابك.