نطاقات API

يحصل /api/v1/domains/

عرض جميع النطاقات

استعادة قائمة بجميع النطاقات المسجلة تحت حسابك.

معلمات الاستعلام

البارامترات	يكتب	مطلوب	وصف المشروع
`status`	string	لا	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	لا	ابحث عن النطاقات بالاسم

مثال على الطلب

cURL

Python

JavaScript

curl -X GET "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

url = "https://admin.vps.org/api/v1/domains/"
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/domains/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

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

مثال على الاستجابة

{
  "count": 3,
  "results": [
    {
      "id": 101,
      "domain_name": "example.com",
      "status": "active",
      "registration_date": "2023-01-15T10:30:00Z",
      "expiration_date": "2026-01-15T10:30:00Z",
      "auto_renew": true,
      "locked": true,
      "nameservers": [
        "ns1.vps.org",
        "ns2.vps.org"
      ],
      "privacy_protection": true,
      "dns_managed_by": "vps.org"
    },
    {
      "id": 102,
      "domain_name": "myapp.io",
      "status": "active",
      "registration_date": "2024-06-20T14:15:00Z",
      "expiration_date": "2025-06-20T14:15:00Z",
      "auto_renew": false,
      "locked": false,
      "nameservers": [
        "ns1.cloudflare.com",
        "ns2.cloudflare.com"
      ],
      "privacy_protection": false,
      "dns_managed_by": "external"
    }
  ]
}

رموز حالة الاستجابة

200	تم استرداد قائمة النطاقات بنجاح
401	غير مصرح به - رمز مصادقة غير صالح أو مفقود

الوظائف /api/v1/domains/

تسجيل نطاق جديد

تسجيل اسم نطاق جديد - ينبغي التحقق من توافر النطاق قبل التسجيل.

معلمات نص الطلب

البارامترات	يكتب	مطلوب	وصف المشروع
`domain_name`	string	نعم	Domain name to register (e.g., "example.com")
`years`	integer	لا	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	لا	Enable automatic renewal (default: true)
`privacy_protection`	boolean	لا	Enable WHOIS privacy protection (default: true)
`nameservers`	array	لا	Custom nameservers (default: VPS.org nameservers)

مثال على الطلب

cURL

Python

JavaScript

PHP

curl -X POST "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_name": "mynewdomain.com",
    "years": 2,
    "auto_renew": true,
    "privacy_protection": true
  }'

import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "domain_name": "mynewdomain.com",
    "years": 2,
    "auto_renew": True,
    "privacy_protection": True
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    domain_name: 'mynewdomain.com',
    years: 2,
    auto_renew: true,
    privacy_protection: true
  })
});

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

$data = [
    'domain_name' => 'mynewdomain.com',
    'years' => 2,
    'auto_renew' => true,
    'privacy_protection' => true
];

$ch = curl_init('https://admin.vps.org/api/v1/domains/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$domain = json_decode($response, true);
curl_close($ch);

مثال على الاستجابة

{
  "id": 103,
  "domain_name": "mynewdomain.com",
  "status": "pending",
  "registration_date": "2026-01-16T16:00:00Z",
  "expiration_date": "2028-01-16T16:00:00Z",
  "auto_renew": true,
  "locked": true,
  "nameservers": [
    "ns1.vps.org",
    "ns2.vps.org"
  ],
  "privacy_protection": true,
  "dns_managed_by": "vps.org",
  "total_cost": 24.98,
  "message": "Domain registration initiated. Processing may take 5-10 minutes."
}

رموز حالة الاستجابة

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	غير مصرح به - رمز مصادقة غير صالح أو مفقود
402	Payment Required - Insufficient account balance

ملاحظة: Domain registration is not instant. Status will change from pending to active within 5-10 minutes. You'll receive an email confirmation when registration completes.

يحصل /api/v1/domains/{domain_id}/

احصل على تفاصيل النطاق

استرجاع معلومات مفصلة عن مجال محدد.

معلمات المسار

البارامترات	يكتب	مطلوب	وصف المشروع
`domain_id`	integer	نعم	Unique domain ID

مثال على الطلب

cURL

Python

JavaScript

curl -X GET "https://admin.vps.org/api/v1/domains/101/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

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

response = requests.get(url, headers=headers)
print(response.json())

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

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

مثال على الاستجابة

{
  "id": 101,
  "domain_name": "example.com",
  "status": "active",
  "registration_date": "2023-01-15T10:30:00Z",
  "expiration_date": "2026-01-15T10:30:00Z",
  "auto_renew": true,
  "locked": true,
  "nameservers": [
    "ns1.vps.org",
    "ns2.vps.org"
  ],
  "privacy_protection": true,
  "dns_managed_by": "vps.org",
  "registrar": "VPS.org",
  "days_until_expiration": 730,
  "whois_info": {
    "registrant": "Privacy Protected",
    "admin_contact": "Privacy Protected",
    "tech_contact": "Privacy Protected",
    "created_date": "2023-01-15",
    "updated_date": "2025-12-20"
  },
  "dns_records_count": 12
}

رموز حالة الاستجابة

200	Successfully retrieved domain details
401	غير مصرح به - رمز مصادقة غير صالح أو مفقود
404	غير موجود - النطاق غير موجود

يضع /api/v1/domains/{domain_id}/

تحديث إعدادات النطاق

تحديث تشكيل النطاق مثل التجديد التلقائي، وخواديم الأسماء، وإعدادات الخصوصية.

معلمات المسار

البارامترات	يكتب	مطلوب	وصف المشروع
`domain_id`	integer	نعم	Unique domain ID

معلمات نص الطلب

البارامترات	يكتب	مطلوب	وصف المشروع
`auto_renew`	boolean	لا	Enable or disable automatic renewal
`privacy_protection`	boolean	لا	Enable or disable WHOIS privacy
`nameservers`	array	لا	Update nameservers (2-4 nameservers required)
`locked`	boolean	لا	Lock or unlock domain to prevent transfers

مثال على الطلب

cURL

Python

JavaScript

curl -X PUT "https://admin.vps.org/api/v1/domains/101/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "auto_renew": false,
    "nameservers": [
      "ns1.cloudflare.com",
      "ns2.cloudflare.com"
    ]
  }'

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "auto_renew": False,
    "nameservers": [
        "ns1.cloudflare.com",
        "ns2.cloudflare.com"
    ]
}

response = requests.put(url, headers=headers, json=data)
print(response.json())

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/`, {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    auto_renew: false,
    nameservers: [
      'ns1.cloudflare.com',
      'ns2.cloudflare.com'
    ]
  })
});

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

مثال على الاستجابة

{
  "id": 101,
  "domain_name": "example.com",
  "status": "active",
  "auto_renew": false,
  "nameservers": [
    "ns1.cloudflare.com",
    "ns2.cloudflare.com"
  ],
  "privacy_protection": true,
  "locked": true,
  "message": "Domain settings updated successfully. Nameserver changes may take up to 24 hours to propagate."
}

رموز حالة الاستجابة

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	غير مصرح به - رمز مصادقة غير صالح أو مفقود
404	غير موجود - النطاق غير موجود

يمسح /api/v1/domains/{domain_id}/

حذف المجال

حذف مجال من حسابك. هذا لا يلغي تسجيل المجال - إنه فقط يزيل من إدارة حسابك VPS.org.

معلمات المسار

البارامترات	يكتب	مطلوب	وصف المشروع
`domain_id`	integer	نعم	Unique domain ID

مثال على الطلب

cURL

Python

JavaScript

curl -X DELETE "https://admin.vps.org/api/v1/domains/101/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

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

response = requests.delete(url, headers=headers)
print(response.status_code)

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

console.log(response.status);

رموز حالة الاستجابة

204	Domain removed from account successfully
401	غير مصرح به - رمز مصادقة غير صالح أو مفقود
404	غير موجود - النطاق غير موجود

Important: Deleting a domain from your VPS.org account does NOT cancel the registration. The domain will continue to be registered and will auto-renew if enabled. To cancel a domain registration, disable auto-renewal and let it expire.

الوظائف /api/v1/domains/{domain_id}/transfer/

نقل النطاق

مباشرة نقل النطاق إلى VPS.org من مسجل آخر.

معلمات المسار

البارامترات	يكتب	مطلوب	وصف المشروع
`domain_id`	integer	نعم	Unique domain ID

معلمات نص الطلب

البارامترات	يكتب	مطلوب	وصف المشروع
`auth_code`	string	نعم	EPP/Authorization code from current registrar
`auto_renew`	boolean	لا	Enable auto-renewal after transfer (default: true)

مثال على الطلب

cURL

Python

JavaScript

curl -X POST "https://admin.vps.org/api/v1/domains/101/transfer/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_code": "Xy9Kl2Mn#4pQ",
    "auto_renew": true
  }'

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/transfer/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "auth_code": "Xy9Kl2Mn#4pQ",
    "auto_renew": True
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/transfer/`, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    auth_code: 'Xy9Kl2Mn#4pQ',
    auto_renew: true
  })
});

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

مثال على الاستجابة

{
  "id": 101,
  "domain_name": "example.com",
  "transfer_status": "pending",
  "transfer_initiated_at": "2026-01-16T16:30:00Z",
  "estimated_completion": "2026-01-23T16:30:00Z",
  "message": "Domain transfer initiated. You should receive a confirmation email from your current registrar. Transfer typically completes within 5-7 days.",
  "next_steps": [
    "Check email for transfer authorization request",
    "Approve transfer with current registrar",
    "Wait for transfer to complete (5-7 days)",
    "Domain will be automatically renewed for 1 year upon completion"
  ]
}

رموز حالة الاستجابة

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	غير مصرح به - رمز مصادقة غير صالح أو مفقود
404	غير موجود - النطاق غير موجود
402	Payment Required - Insufficient account balance for transfer fee

متطلبات النقل:

يجب أن يكون النطاق مفتوحاً لدى المسجل الحالي
يجب أن يكون عمر النطاق 60 يوماً على الأقل
مطلوب رمز EPP/Auth صالح
يجب أن يكون البريد الإلكتروني لنظام معلومات هوية المستعمل متاحاً للموافقة عليه
يشمل النقل تجديداً لمدة سنة واحدة (تطبق رسوم)

تسعير النطاق

النطاقات الشعبية العليا

النطاقات العليا	التسجيل (سنة واحدة)	تجديد	النقل
.com	$12.99	$12.99	$12.99
.net	$14.99	$14.99	$14.99
.org	$13.99	$13.99	$13.99
.io	$39.99	$39.99	$39.99
.dev	$14.99	$14.99	$14.99
.app	$14.99	$14.99	$14.99
.co	$24.99	$24.99	$24.99

الميزات المضمنة

✓ حماية الخصوصية
✓ إدارة الـ DNS المجانية
✓ إحالة البريد الإلكتروني المجانية
✓ إعادة توجيه النطاق المجاني

✓ قفل النطاق المجاني
✓ دعم 24/7
✓ إدارة النطاقات
✓ خيار التجديد التلقائي

أفضل الممارسات في إدارة النطاقات

دال - الأمن

تمكين قفل النطاق: منع عمليات النقل غير المأذون بها
حماية الخصوصية: يخفي معلوماتك الشخصية من WHOIS
استخدم كلمات مرور قوية: حماية حسابك VPS.org
Enable 2FA: أضف أمناً إضافياً لحسابك
رصد تواريخ انتهاء الصلاحية: إنشاء تجديد تلقائي أو تذكير تقويمي

التشكيل

إعداد DNS: حدد VPS.org لخدمات خدمة الأسماء من أجل الإدارة السهلة
التجديد التلقائي: تمكين منع انتهاء النطاق العرضي
معلومات الاتصال: 1 - تحديث معلومات الاتصال في نظام WHOIS
النسخ الاحتياطي DNS: النظر في مقدم خدمات DNS الثانوي للاحتياط

التحويلات

60 يوما: لا يمكن نقل النطاقات خلال 60 يوما من التسجيل أو النقل السابق
النطاق: يجب فتحه لدى المسجل الحالي قبل النقل
رمز التحقق: طلب رمز البرنامج الإلكتروني للتسجيل/الترخيص من المسجل الحالي
البريد الإلكتروني: ستتلقى رسائل موافقة عبر البريد الإلكتروني أثناء عملية النقل
التخطيط للمستقبل: يمكن أن يستغرق إنجاز التحويلات 5-7 أيام

VPS.org API

نطاقات API

عرض جميع النطاقات

معلمات الاستعلام

مثال على الطلب

مثال على الاستجابة

رموز حالة الاستجابة

تسجيل نطاق جديد

معلمات نص الطلب

مثال على الطلب

مثال على الاستجابة

رموز حالة الاستجابة

احصل على تفاصيل النطاق

معلمات المسار

مثال على الطلب

مثال على الاستجابة

رموز حالة الاستجابة

تحديث إعدادات النطاق

معلمات المسار

معلمات نص الطلب

مثال على الطلب

مثال على الاستجابة

رموز حالة الاستجابة

حذف المجال

معلمات المسار

مثال على الطلب

رموز حالة الاستجابة

نقل النطاق

معلمات المسار

معلمات نص الطلب

مثال على الطلب

مثال على الاستجابة

رموز حالة الاستجابة

تسعير النطاق

النطاقات الشعبية العليا

الميزات المضمنة

أفضل الممارسات في إدارة النطاقات

دال - الأمن

التشكيل

التحويلات