VPS.org API

وثائق واجهة برمجة تطبيقات REST

وثائق واجهة برمجة التطبيقات (API) الخاصة بموقع VPS.org

وثائق REST API كاملة لإدارة خوادم VPS والنطاقات ونظام أسماء النطاقات (DNS) والنسخ الاحتياطية والمزيد.

عنوان URL الأساسي https://admin.vps.org/api/v1
المصادقة رمز حامل
إصدار v1.0
شكل JSON

ابدء

تتيح لك واجهة برمجة التطبيقات VPS.org إدارة جميع جوانب البنية التحتية لاستضافة VPS الخاصة بك برمجيًا، بما في ذلك الخوادم والنطاقات وسجلات DNS والنسخ الاحتياطية واللقطات.

المصادقة

تتطلب جميع طلبات واجهة برمجة التطبيقات (API) المصادقة باستخدام رمز حامل (Bearer token). يمكنك إنشاء رمز واجهة برمجة التطبيقات الخاص بك من إعدادات حسابك على admin.vps.org/account/developers/.

cURL
Python
JavaScript
curl -X GET https://admin.vps.org/api/v1/servers/ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

url = "https://admin.vps.org/api/v1/servers/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch('https://admin.vps.org/api/v1/servers/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

تحديد معدل الاستخدام

يقتصر عدد طلبات واجهة برمجة التطبيقات (API) على 300 طلب كل 5 دقائق لكل رمز API. تُدرج معلومات حد المعدل في رؤوس الاستجابة.

معالجة الأخطاء

تستخدم واجهة برمجة التطبيقات رموز حالة HTTP القياسية للإشارة إلى النجاح أو الفشل:

رمز الحالة وصف
200 نجاح - تم إكمال الطلب بنجاح
201 تم الإنشاء - تم إنشاء المورد بنجاح
400 طلب غير صالح - معلمات غير صالحة أو طلب غير صحيح
401 غير مصرح به - رمز مصادقة غير صالح أو مفقود
403 ممنوع - لا توجد أذونات كافية
404 غير موجود - المورد غير موجود
429 عدد الطلبات كبير جدًا - تم تجاوز الحد المسموح به
500 خطأ في الخادم الداخلي - حدث خطأ ما من جانبنا

فئات واجهة برمجة التطبيقات

تصفح وثائق واجهة برمجة التطبيقات (API) الخاصة بنا حسب الفئة:

واجهة برمجة تطبيقات الخوادم 9 نقاط نهاية

إنشاء وإدارة والتحكم في خوادم VPS. يشمل ذلك إدارة الطاقة، وتغيير الحجم، وإعادة التثبيت، واسترجاع معلومات الخادم.

عرض الوثائق
واجهة برمجة تطبيقات النسخ الاحتياطي 3 نقاط نهاية

إدارة النسخ الاحتياطية الآلية واليدوية لخوادمك. عرض وإنشاء واستعادة وحذف النسخ الاحتياطية للخوادم.

عرض الوثائق
واجهة برمجة تطبيقات اللقطات 4 نقاط نهاية

أنشئ وقم بإدارة لقطات الخادم للحصول على نقاط استعادة سريعة. مثالية للاختبار والتراجع السريع.

عرض الوثائق
واجهة برمجة تطبيقات الخطط نقطتا نهاية

استرجع خطط الخوادم الافتراضية الخاصة المتاحة ومعلومات الأسعار. احصل على تفاصيل حول الموارد والأسعار والتوافر.

عرض الوثائق
واجهة برمجة تطبيقات أنظمة التشغيل نقطتا نهاية

قائمة بأنظمة التشغيل والصور المتاحة لنشر الخوادم. تشمل أوبونتو، وديبيان، وسنت أو إس، وغيرها.

عرض الوثائق
واجهة برمجة تطبيقات النطاقات 6 نقاط نهاية

ابحث عن أسماء النطاقات، وتحقق من توفرها، وسجلها، وقم بإدارتها. أكمل إدارة دورة حياة النطاق بالكامل من خلال واجهة برمجة التطبيقات (API).

عرض الوثائق
واجهة برمجة تطبيقات نظام أسماء النطاقات (DNS API) 4 نقاط نهاية

إدارة مناطق وسجلات نظام أسماء النطاقات (DNS) برمجياً. إنشاء وتحديث وحذف أنواع السجلات A وAAAA وCNAME وMX وTXT وغيرها.

عرض الوثائق
واجهة برمجة تطبيقات المواقع نقطة نهاية واحدة

استعرض مواقع مراكز البيانات المتاحة لنشر الخوادم. اختر من بين مناطق متعددة حول العالم.

عرض الوثائق

هل تحتاج إلى مساعدة؟

إذا كانت لديك أسئلة أو كنت بحاجة إلى مساعدة بخصوص واجهة برمجة التطبيقات (API)، فلا تتردد في التواصل معنا: