DNS ਪ੍ਰਬੰਧਨ API

ਸੰਖੇਪ ਜਾਣਕਾਰੀ

ਇੱਕ ਜ਼ੋਨ ਇੱਕ ਡੋਮੇਨ ਲਈ ਰਿਕਾਰਡ ਰੱਖਦਾ ਹੈ । API ਰਾਹੀਂ ਕੀਤੀਆਂ ਹਰੇਕ ਤਬਦੀਲੀਆਂ VPS.org ਨਾਂ ਸਰਵਰਾਂ ਨੂੰ ਤੁਰੰਤ ਭੇਜੀਆਂ ਜਾਂਦੀਆਂ ਹਨ । ਇਨ੍ਹਾਂ ਜ਼ੋਨ ਤੋਂ ਡੋਮੇਨ ਦੀ ਸੇਵਾ ਕਰਨ ਲਈ, ਆਪਣੇ ਰਜਿਸਟਰਾਰੀ ਵਿੱਚ ਇਸ ਦੇ ਨਾਂ ਸਰਵਰਾਂ ਨੂੰ 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 ਜ਼ੋਨਾਂ ਦੀ ਸੂਚੀ ਬਣਾਓ

ਤੁਹਾਡੇ ਖੇਤਰਾਂ ਨੂੰ ਮੁੜ- ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ, ਨਵਾਂ ਪਹਿਲਾਂ, ਪ੍ਰਤੀ ਸਫ਼ਾ ੨੫ । ਰਿਕਾਰਡ ਇੱਥੇ ਸ਼ਾਮਲ ਨਹੀਂ ਹਨ; ਉਨ੍ਹਾਂ ਨੂੰ ਲੈਣ ਲਈ ਇੱਕ ਇੱਕਲਾ ਖੇਤਰ ਲਵੋ ।

ਪੁੱਛਗਿੱਛ ਪੈਰਾਮੀਟਰ

ਉਦਾਹਰਨ ਬੇਨਤੀ

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 ਜ਼ੋਨ ਵਿੱਚ ਹਰ ਰਿਕਾਰਡ ਨੂੰ ਇੱਕ ਸਧਾਰਨ ਐਰੇ (ਪੇਜਡ ਨਹੀਂ) ਦੇ ਰੂਪ ਵਿੱਚ ਮੁੜ ਦਿੰਦਾ ਹੈ, ਜੋ ਕਿ ਕਿਸਮ ਅਤੇ ਨਾਂ ਨਾਲ ਲੜੀਬੱਧ ਹੈ । 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 ਨਾਂ ਸਰਵਰਾਂ ਨੂੰ ਸਿੱਧਾ ਪੁੱਛੋ, ਤਾਂ ਕਿ ਇੱਕ ਤਬਦੀਲੀ ਦੀ ਪੁਸ਼ਟੀ ਹੋਵੇ, ਜਦੋਂ ਤੱਕ ਤੁਹਾਡੀ ਰਜਿਸਟਰੇਸ਼ਨ delegation ਜਾਂ resolving ਕੈਸ਼ ਫੜਨ ਤੋਂ ਪਹਿਲਾਂ:

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