DNS කළමනාකරණ API

දළ විශ්ලේෂණය

DNS API DNS කලාප හා වාර්තා සම්පූර්ණ කළමනාකරණය සපයයි. සියලු කලාප ස්වයංක්රීය BIND9 කලාප ගොනු ජනනය සහ යෙදවීම සමග VPS.org ගේ බලයලත් නාම සර්වර මත සත්කාරකත්වය සපයයි.

නාමසර්වර යටිතල පහසුකම්

• 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 වාර්තා වර්ග සඳහා සහාය (ඒ, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• ඩොමේන් නාමය පෙරහන් සහ UUID-පාදක කලාප හඳුනාගැනීම
• කලාප-විශේෂ වාර්තා කළමනාකරණය සඳහා ස්ථානගත මාර්ග

සත්‍යාපනය

සියලු DNS API ඉල්ලීම් දරන්නා ටෝකන් සහතික කිරීම අවශ්ය. ඔබේ ගිණුම දර්ශක පුවරුව සිට API ටෝකන් ජනනය /account/developers/ පහත සඳහන් අවසර සමඟ:

• dns:list - DNS කලාප සහ වාර්තා බලන්න
• dns:create - නව කලාප හා වාර්තා නිර්මාණය කරන්න
• dns:update - දැනට පවතින කලාප හා වාර්තා වෙනස් කරන්න
• dns:delete - කලාප හා වාර්තා මකන්න
• dns:* - සම්පූර්ණ DNS කළමනාකරණ ප්රවේශය

උදාහරණය

Authorization: Bearer vps_abc123def456...

සියලුම DNS කලාප ලැයිස්තුගත කරන්න

සියලු DNS කලාප හිමි සත්යාපනය පරිශීලක විසින් paginated ලැයිස්තුවක් ලබා ගන්න. ඩොමේන් නාමය විසින් පෙරහන් සහාය.

විමසුම් පරාමිතීන්

උදාහරණ ඉල්ලීම

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 වාර්තාවක් නිර්මාණය කරන්න

විශේෂිත කලාපයක් (නිදන්ගත මාර්ගය) නව 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 මූල හෝ වෙන් වාර්තාව යොමු භාවිතා කළ හැක
• විද්‍යුත් තැපෑල (MX): සෑම විටම ප්රමුඛතාව ඇතුළත්, අඩු අංකය = ඉහළ ප්රමුඛතාව
• CNAME: එකම නාමය සඳහා වෙනත් වාර්තා වර්ග සමග සහයෝගීව පැවතිය නොහැක

ආරක්ෂාව

• CAA වාර්තා: සහතික නිකුත් කළ හැකි CA යන් සඳහන් කරන්න
• SPF/DKIM/DMARC: විද්‍යුත් තැපැල් සහතික කිරීම සකසන්නName
• නිතිපතා විගණන: 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