DNS කළමනාකරණ API

දළ විශ්ලේෂණය

කලාපයක් එක් ඩොමේන් සඳහා වාර්තා පවතී. API හරහා ඔබ සිදු කරන සෑම වෙනස්කමකින් VPS.org nameservers වහාම තල්ලු කරනු ලැබේ. මෙම කලාප වලින් ඩොමේන් සේවය කිරීමට, ns1.vps.org, ns2.vps.org සහ ns3.vps.org ඔබේ ලියාපදිංචිකරු එහි nameservers සකස්.

වෙනස්කම් එක් පියවරක් තුළ සුරැකෙන අතර ප්රකාශයට පත් වේ: නම් සේවාදායකය වෙනස් කිරීමක් ප්රතික්ෂේප නම්, ඉල්ලීම 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 කලාපය නිර්මාණය කරන්න

කලාපයක් නිර්මාණය හා එය ප්රකාශයට පත් කරයි. කලාපය ns1, ns2 හා ns3.vps.org සඳහා NS වාර්තා තුනක් සමග ආරම්භ වන අතර, පද්ධති වාර්තා වන හා සංස්කරණය හෝ මකා දැමිය නොහැකි වේ.

ඉල්ලීම් ශරීර පරාමිතීන්

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 වර්ගය හා නම අනුව වර්ග කර, සරල ආකෘතිය (pageted නොවේ) ලෙස කලාපයේ සෑම වාර්තාවක් ලෙස ආපසු. 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 lookups දක්වා පෙන්නුම් නොකරන විට මෙම භාවිතා කරන්න. ඉල්ලීම ශරීරය අවශ්ය නොවේ.

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, නම, අගය හා TTL අවශ්යතා. පැච් ඔබ යැවීමට ක්ෂේත්ර පමණක් වෙනස්. 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}'

ප්‍රතිචාර තත්ව කේත

දෝෂ හැසිරවීම

වලංගු දෝෂ ක්ෂේත්ර නාමය විසින් keyed ගැටලුව සමග 400 ආපසු:

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

DNS වෙනස්කම් පරීක්ෂා කිරීම

වෙනස් කිරීම ඔබේ ලියාපදිංචි නියෝජිතයා හෝ විසඳුම් කැච් අල්ලා ගැනීමට පෙර සජීවී බව තහවුරු කිරීමට VPS.org nameservers කෙලින්ම විමසන්න:

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