DNS నిర్వహణ API

అవలోకనం

A zone holds the records for one domain. Every change you make through the API is pushed to the VPS.org nameservers straight away. To serve a domain from these zones, set its nameservers at your registrar to ns1.vps.org, ns2.vps.org and ns3.vps.org.

Changes are saved and published in one step: if the nameservers refuse a change, the request returns 502 and nothing is saved. A zone cannot be created for a domain another account already manages, a parent or child of another account's zone, or a VPS.org reserved name.

అనుమతించు: 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 జోన్‌ను సృష్టించుము

Creates a zone and publishes it. The zone starts with three NS records for ns1, ns2 and ns3.vps.org, which are system records and cannot be edited or deleted.

బాడీ పారామితులను అభ్యర్థించండి

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 returns every record in the zone as a plain array (not paginated), sorted by type and name. POST adds a record to the zone and publishes it.

బాడీ పారామితులను అభ్యర్థించండి (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, పేజీ, కంటైన్, టైప్ మరియు పేరుచేత నిర్దేశించబడిన రికార్డులను తిరిగిస్పందిస్తుంది. Pource reports of the default evice వలె ను సృష్టిస్తుంది, అయితే జోన్‌ను స్థితి థీమరీతినందు ను symid_ uidguid గా యిస్తుంది.

ప్రశ్న పారామితులు

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 ఒక రికార్డ్ తిరిగివుంచుతుంది. దానిని పునఃస్థాపించుము మరియు రికార్డు_type, పేరు, విలువ, tl. PTCC మార్పులను మాత్రమే బదిలీ చేస్తుంది. DEE ట్రాక్ట్ తీసివేస్తుంది మరియు ఏ శరీరంతోనైనా 204ని పంపుతుంది. నేరుగా ప్రచురించబడుతుంది. ఎన్ఎస్ సిస్టమ్ తో సృష్టించబడిన మార్పులు సరిపోతుంది. లేదా తీసివేయబడతాయి: వాటిని 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}'

ప్రతిస్పందన స్థితి కోడ్‌లు

వ్యవహరించుటలో దోషముNAME OF TRANSLATORS

ఫీల్‍డ్ పేరుతో సమస్యతో పరిశీలన చేసిన దోషం 400కు తిరిగివుంది:

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

DNS మార్పులను పరీక్షించుచున్నది

Query the VPS.org nameservers directly to confirm a change is live before your registrar delegation or resolver caches catch up:

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