ڊي اين ايس مئنيجمينٽ API

جائزو

DNS API DNS علائقن ۽ رڪارڊن جو مڪمل انتظام فراهم ڪري ٿو. سڀ علائقا VPS.org جي معتبر نيم سرورز تي خودڪار BIND9 علائقي جي فائل پيدا ڪرڻ ۽ استعمال سان ميزبان ڪيا ويا آهن.

نيم سرورز

• ns1.vps.org (38.248.6.195) - پرائمري ماسٽر سان DNSSEC لاڳاپيل دستخط
• ns2.vps.org (38.248.6.196) - ثانوي ٻانھن
• ns3.vps.org (38.248.6.197) - ثانوي ٻانھن

خاصيتون

• خودڪار BIND9 زون فائل پيدا ڪرڻ ۽ استعمال ڪرڻ
• TSIG تصديق ذريعي زون منتقلي (ماستر-سليب نقل)
• سڀني وڏين DNS رڪارڊ قسمن لاءِ مدد (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• ڊومين نڪتو فلٽرنگ ۽ UUID-based زون شناخت
• علائقي مخصوص رڪارڊ جي انتظام لاءِ داخل ٿيل واٽون

تصديق

سڀني DNS API درخواستن کي بيئرر ٽوڪين تصديق جي ضرورت آھي. API ٽوڪين کي پنھنجي اڪائونٽ ڊش بورڊ تان پيدا ڪريو /account/developers/ ھيءُ اجازتون:

• dns:list - DNS زونز ۽ رڪارڊ ڏسو
• dns:create - نئون علائقو ۽ رڪارڊ ٺاهيو
• dns:update - موجود علائقن ۽ رڪارڊن کي تبديل ڪريو
• dns:delete - ريڪارڊ
• dns:* - مڪمل DNS مئنيجمينٽ رسائي

مثال

Authorization: Bearer vps_abc123def456...

سڀني DNS زونن جي فهرست ڏيو

تصديق ٿيل استعمال ڪندڙ جي مالڪيءَ ۾ سڀني DNS زونن جو صفحن وارو فہرست حاصل ڪريو. ڊومين جي نالي سان فلٽر ڪرڻ کي مدد ڏئي ٿو.

سوال جا پيرا ميٽر

مثال جي درخواست

curl -X GET "https://admin.vps.org/api/v1/dns-zones/" \
  -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)
print(response.json())

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

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

مثال جواب

[
  {
    "uuid": "abc123-def456-ghi789",
    "domain": "example.com",
    "created_at": "2024-01-15T10:30:00Z",
    "record_count": 12
  },
  {
    "uuid": "xyz789-uvw456-rst123",
    "domain": "myapp.io",
    "created_at": "2024-06-20T14:15:00Z",
    "record_count": 8
  }
]

جوابي ميدان

جوابي اسٽيٽس ڪوڊس

DNS زون جون تفصيلون حاصل ڪريو

خاص DNS زون بابت تفصيلي معلومات حاصل ڪريو، سمورين رڪارڊن سميت.

رستي جا پيرا ميٽر

مثال جواب

{
  "uuid": "abc123-def456-ghi789",
  "domain": "example.com",
  "created_at": "2024-01-15T10:30:00Z",
  "record_count": 5,
  "records": [
    {
      "uuid": "rec-001",
      "record_type": "A",
      "name": "@",
      "value": "192.0.2.1",
      "ttl": 3600,
      "priority": null,
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "uuid": "rec-002",
      "record_type": "MX",
      "name": "@",
      "value": "mail.example.com",
      "ttl": 3600,
      "priority": 10,
      "created_at": "2024-01-15T10:32:00Z"
    }
  ]
}

جوابي اسٽيٽس ڪوڊس

DNS زون ٺاهيو

ڊومين لاءِ نئون DNS زون ٺاهيو. زون فوري طور تي 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": "newdomain.com"}'

import requests

url = "https://admin.vps.org/api/v1/dns-zones/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {"domain": "newdomain.com"}

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

const response = await fetch('https://admin.vps.org/api/v1/dns-zones/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({domain: 'newdomain.com'})
});

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

مثال جواب

{
  "uuid": "new-zone-uuid",
  "domain": "newdomain.com",
  "created_at": "2026-01-18T16:45:00Z",
  "record_count": 0,
  "records": []
}

جوابي اسٽيٽس ڪوڊس

DNS زون حذف ڪريو

DNS زون ۽ سڀ لاڳاپيل رڪارڊ سدائين لاءِ حذف ڪريو. هي عمل واپس نه ورتو ويندو.

رستي جا پيرا ميٽر

جوابي اسٽيٽس ڪوڊس

زون ۾ DNS رڪارڊن جي قائمة

خاص علائقي (نيٽڊ روٽ) لاءِ سڀ DNS رڪارڊ حاصل ڪريو.

رستي جا پيرا ميٽر

مثال جي درخواست

curl -X GET "https://admin.vps.org/api/v1/dns-zones/{uuid}/records/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

مثال جواب

[
  {
    "uuid": "rec-001",
    "record_type": "A",
    "name": "@",
    "value": "192.0.2.1",
    "ttl": 3600,
    "priority": null,
    "created_at": "2024-01-15T10:30:00Z"
  },
  {
    "uuid": "rec-002",
    "record_type": "MX",
    "name": "@",
    "value": "mail.example.com",
    "ttl": 3600,
    "priority": 10,
    "created_at": "2024-01-15T10:32:00Z"
  }
]

ڊائنس ريڪارڊ ٺاهيو

خاص علائقي (نيٽڊ روٽ) ۾ نئون DNS رڪارڊ شامل ڪريو.

درخواست باڊي پيرا ميٽرز

مثال جي درخواست

curl -X POST "https://admin.vps.org/api/v1/dns-zones/{uuid}/records/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "record_type": "A",
    "name": "www",
    "value": "192.0.2.1",
    "ttl": 3600
  }'

import requests

url = f"https://admin.vps.org/api/v1/dns-zones/{zone_uuid}/records/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "record_type": "A",
    "name": "www",
    "value": "192.0.2.1",
    "ttl": 3600
}

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

جوابي اسٽيٽس ڪوڊس

DNS رڪارڊن جو انتظام (سڌو رسائي)

رڪارڊ UUID استعمال ڪندي انفرادي DNS رڪارڊن تي مڪمل CRUD آپريشن.

دستياب آپريشن

• GET /api/v1/dns-records/{uuid}/ - Retrieve record details
• PUT /api/v1/dns-records/{uuid}/ - Full update (all fields required)
• PATCH /api/v1/dns-records/{uuid}/ - Partial update (only changed fields)
• DELETE /api/v1/dns-records/{uuid}/ - Delete record

سوال جي پيرا ميٽر (GET /api/v1/dns-records/ لاءِ)

مثال: رڪارڊ جي TTL جي تازه ڪاري

curl -X PATCH "https://admin.vps.org/api/v1/dns-records/{rec-uuid}/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ttl": 1800}'

Supported DNS Record Types

بهترين طريقا

TTL ڪنٽرول

• پيداوار (سڌو): 3600-86400 سيڪنڊ (1-24 ڪلاڪ)
• منتقل ڪرڻ کان اڳ: 300- 600 سيڪنڊ (5- 10 منٽ) - TTL کي منصوبابندي ڪيل تبديلين کان اڳ گھٽايو
• ترقي: 300-1800 سيڪنڊ (5-30 منٽ) تيز آزمائش لاءِ

عام نمونا

• جڳھ A/AAAA رڪارڊ استعمال ڪريو، نه ته CNAME
• www سبڊومين: CNAME اشارو روت يا جدا A رڪارڊ استعمال ڪري سگھجي ٿو
• اي ميل (MX): هميشه ترجيح شامل ڪر، ننڍو نمبر = وڏي ترجيح
• CNAME: ھڪ ئي نالي لاءِ ٻيون رڪارڊ جون قسمون گڏجي نه ٿي سگھن

حفاظت

• CAA رڪارڊ: ڪھڙيون CAs سرٽيفڪيٽ جاري ڪري سگھن ٿيون
• SPF/DKIM/DMARC: اي ميل تصديق کي ٺاھيو ته جيئن ڦرلٽ کان بچي سگهجي
• منظم حساب ڪتاب: DNS رڪارڊ چار مهينا نظرثاني ڪريو، نا استعمال ٿيل داخلا ختم ڪريو

غلطي جو سنڀاليندڙ

عام غلطيون

مثالي غلطي جو جواب

{
  "detail": "MX records require a priority value",
  "error_code": "validation_error",
  "field": "priority"
}

DNS تبديليون آزمائي رهيو آهي

رڪارڊ جي واڌ کي جانچيو

# Query A record
dig example.com A

# Query specific nameserver
dig @ns1.vps.org example.com

# Query MX records
dig example.com MX

# Check all records
dig example.com ANY

آن لائن وسيلن جو استعمال

• whatsmydns.net: Check global DNS propagation
• dnschecker.org: Multi-location DNS lookup
• mxtoolbox.com: Email-related DNS testing