واجهة برمجة تطبيقات إدارة نظام أسماء النطاقات (DNS)

ملخص

تحتوي المنطقة على السجلات لنطاق واحد. كل تغيير تقوم به من خلال API يتم دفعه إلى VPS.org nameservers على الفور. لخدمة مجال من هذه المناطق، حدد خواديم أسمائه في مسجلك إلى ns1.vps.org، ns2.vps.org و ns3.vps.org.

يتم حفظ التغييرات ونشرها في خطوة واحدة: إذا رفضت خوادم الأسماء تغييرًا، يعود الطلب 502 ولا يتم حفظ أي شيء. لا يمكن إنشاء منطقة لنطاق يدير حساب آخر بالفعل، أو منطقة والدية أو طفلية لحساب آخر، أو اسم محجوز VPS.org.

الإذن المطلوب: dns:list (GET), dns:create (POST), dns:update (PUT, PATCH, sync), dns:delete (DELETE), dns:*

عرض جميع نطاقات نظام أسماء النطاقات (DNS)

يعيد مناطقك، أحدث أولاً، 25 في كل صفحة. السجلات غير مدرجة هنا؛ أخذ منطقة واحدة للحصول عليها.

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

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

curl -X GET "https://admin.vps.org/api/v1/dns-zones/?domain=example.com" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

url = "https://admin.vps.org/api/v1/dns-zones/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers, params={"domain": "example.com"})
for zone in response.json()["results"]:
    print(zone["uuid"], zone["domain"], zone["record_count"])

const response = await fetch('https://admin.vps.org/api/v1/dns-zones/?domain=example.com', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

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

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

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c",
      "domain": "example.com",
      "created_at": "2026-09-06T03:11:48.829693Z",
      "record_count": 5
    }
  ]
}

حقول الاستجابة

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

إنشاء منطقة DNS

تبدأ المنطقة بثلاثة سجلات NS لـ ns1 و ns2 و ns3.vps.org، وهي سجلات نظام ولا يمكن تحريرها أو حذفها.

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

curl -X POST "https://admin.vps.org/api/v1/dns-zones/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

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

{
  "uuid": "c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c",
  "domain": "example.com",
  "created_at": "2026-09-14T21:02:11.402113Z",
  "records": [
    {
      "uuid": "1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b",
      "record_type": "NS",
      "name": "@",
      "value": "ns1.vps.org",
      "ttl": 86400,
      "priority": null,
      "created_at": "2026-09-14"
    },
    ...
  ],
  "record_count": 3
}

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

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

يعيد منطقة واحدة مع جميع سجلاتها في صفيفة سجلات. الاستجابة لها نفس الشكل كما استجابة إنشاء أعلاه.

curl -X GET "https://admin.vps.org/api/v1/dns-zones/c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

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

حذف منطقة DNS

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

curl -X DELETE "https://admin.vps.org/api/v1/dns-zones/c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

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

قائمة أو إضافة سجلات في منطقة

GET يعيد كل سجل في المنطقة كمصفوفة بسيطة (غير صفحة)، مرتبة حسب النوع والعنوان. POST يضيف سجل إلى المنطقة وينشره.

معلمات نص الطلب (POST)

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

curl -X POST "https://admin.vps.org/api/v1/dns-zones/c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c/records/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"record_type": "MX", "name": "@", "value": "mail.example.com", "ttl": 3600, "priority": 10}'

import requests

zone_uuid = "c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c"
url = f"https://admin.vps.org/api/v1/dns-zones/{zone_uuid}/records/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
data = {"record_type": "A", "name": "www", "value": "203.0.113.10", "ttl": 3600}

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

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

{
  "uuid": "9d430082-5562-42b4-a0b2-12a6f6c862f9",
  "record_type": "MX",
  "name": "@",
  "value": "mail.example.com",
  "ttl": 3600,
  "priority": 10,
  "created_at": "2026-09-14"
}

حقول الاستجابة

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

إعادة نشر منطقة

يدفع المنطقة وجميع سجلاتها إلى خواديم الأسماء مرة أخرى. تنشر تغييرات السجلات تلقائياً، ولكن النشر هو أفضل جهد والفشل لا يفشل الطلب الأصلي، لذلك استخدم هذا عندما لا يظهر تغيير في بحث DNS. لا يلزم وجود جسد طلب.

curl -X POST "https://admin.vps.org/api/v1/dns-zones/c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c/sync/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "detail": "Zone example.com synced to PowerDNS"
}

قائمة أو إنشاء سجلات عبر المناطق

GET يعيد سجلات جميع مناطقك، 25 لكل صفحة، مرتبة حسب المجال، النوع، والعنوان. POST يخلق سجلاً مثل نقطة نهاية سجلات المنطقة، ولكنه يأخذ المنطقة في الجسم كzone_uuid.

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

curl -X GET "https://admin.vps.org/api/v1/dns-records/?zone=c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c&record_type=A" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X POST "https://admin.vps.org/api/v1/dns-records/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"zone_uuid": "c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c", "record_type": "TXT", "name": "@", "value": "v=spf1 mx -all", "ttl": 3600}'

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "4b8e2c10-7d3f-4a5b-9e6c-1a2b3c4d5e6f",
      "record_type": "A",
      "name": "www",
      "value": "203.0.113.10",
      "ttl": 3600,
      "priority": null,
      "created_at": "2026-09-14"
    }
  ]
}

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

الحصول على، تحديث أو حذف سجل

GET يعيد سجل واحد. PUT يستبدل هذا السجل ويحتاج إلى record_type، name، value و ttl. PATCH يغير الحقول التي ترسلها فقط. DELETE يزيل السجل ويعيد 204 بدون جسد. التغييرات تنشر فورا. السجلات NS التي أنشئت مع المنطقة هي سجلات النظام: تحديثها أو حذفها يعيد 403.

curl -X PATCH "https://admin.vps.org/api/v1/dns-records/4b8e2c10-7d3f-4a5b-9e6c-1a2b3c4d5e6f/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ttl": 300}'

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

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

أخطاء التحقق تعيد 400 مع المشكلة المفتاحية من اسم الحقل:

{
  "priority": ["MX records require a priority value"]
}

اختبار تغييرات DNS

استفسر عن خوادم الأسماء VPS.org مباشرة للتأكد من أن التغيير هو حي قبل تفويض المسجل أو حل مخزن اللحاق:

dig @ns1.vps.org example.com A
dig @ns2.vps.org example.com MX
dig @ns3.vps.org www.example.com