VPS.org API

ಪರೀಕ್ಷಕ API ದಸ್ತಾವೇಜೀಕರಣQuery

DNS ನಿರ್ವಹಣಾ API

ನಿಮ್ಮ ಡೊಮೇನ್‌ಗಳಿಗಾಗಿ DNS ವಲಯಗಳು ಮತ್ತು ದಾಖಲೆಗಳನ್ನು ಪ್ರೋಗ್ರಾಮ್ಯಾಟಿಕ್ ಆಗಿ ನಿರ್ವಹಿಸಿ.

ಅಂತ್ಯಬಿಂದುಗಳು 4 ಅಂತ್ಯಬಿಂದುಗಳು
ಬೇಸ್ ಪಾತ್ /api/v1/dns-zones
ದೃಢೀಕರಣ ಬಿಯರ್‌ ಟೋಕನ್‌ ಅಗತ್ಯವಿದೆ

ಅವಲೋಕನ

DNS API DNS ವಲಯಗಳು ಹಾಗು ದಾಖಲೆಗಳ ಪೂರ್ಣ ನಿರ್ವಹಣೆಯನ್ನು ಒದಗಿಸುತ್ತದೆ. ಎಲ್ಲಾ VPS.org ದ ಅಧಿಕೃತ ಹೆಸರು ಪರಿಚಾರಕಗಳು ಸ್ವಯಂಚಾಲಿತವಾಗಿ BIND9 ವಲಯದ ಉತ್ಪಾದನೆ ಮತ್ತು ಪರಿಮಾಣ ಕಾರ್ಯಯೋಜನೆಯೊಂದಿಗೆ ಸ್ಥಾಪನೆಗೊಂಡಿದ್ದಾರೆ.

ಹೆಸರು ಸರ್ವರ್ ಅನುಸ್ಥಾಪಕ (ಸರ್ವರ್) Comment

ಕೀಲಿ ವೈಶಿಷ್ಟ್ಯಗಳು

ದೃಢೀಕರಣ

ಎಲ್ಲಾ DNS API ಮನವಿಗಳಿಗೆ ಗೂಢಲಿಪೀಕರಿಸುವ ಧೃಡೀಕರಣದ ಅಗತ್ಯವಿದೆ. ನಿಮ್ಮ ಖಾತೆಯಿಂದ API ಗೂಢಲಿಪಕಗಳನ್ನು (documentation) ತಯಾರಿಸಿ /account/developers/ ಈ ಕೆಳಗಿನ ಅನುಮತಿಗಳೊಂದಿಗೆ:

ಉದಾಹರಣೆComment

Authorization: Bearer vps_abc123def456...
ಪ್ರಾಮುಖ್ಯ: API ಗುರುತುಗಳನ್ನು ಕೇವಲ ಒಂದು ಬಾರಿ ಮಾತ್ರ ತೋರಿಸಲಾಗುತ್ತದೆ. ಅವುಗಳನ್ನು ಸುರಕ್ಷಿತವಾಗಿ ಶೇಖರಿಸಿ. ನೀವು ಒಂದು ಸೂಚಕವನ್ನು ಕಳೆದುಕೊಂಡರೆ, ಹೊಸದನ್ನು ರಚಿಸಬೇಕು.
ಪಡೆಯಿರಿ /api/v1/dns-zones/

ಎಲ್ಲಾ DNS ವಲಯಗಳನ್ನು ಪಟ್ಟಿ ಮಾಡಿ

ಧೃಡೀಕರಿಸಲಾದ ಬಳಕೆದಾರನಿಗೆ ಸಂಬಂಧಿಸಿದ ಎಲ್ಲಾ DNS ವಲಯಗಳ ಪಟ್ಟಿಯನ್ನು ಪಡೆದುಕೊಳ್ಳಿ. ಡೊಮೈನ್ ಹೆಸರಿನೊಂದಿಗೆ ಶೋಧಿತಗೊಳ್ಳುವುದನ್ನು ಬೆಂಬಲಿಸುತ್ತದೆ.

ಪ್ರಶ್ನೆ ನಿಯತಾಂಕಗಳು

ಮಾಪನಾಂಕ ನಿರ್ಣಯ (ಕ್ಯಾಲಿಬ್ರೇಷನ್) ಪ್ರಕಾರ ಅಗತ್ಯವಿದೆ ವಿವರಣೆ
domain string ಇಲ್ಲ Filter zones by exact domain name (e.g., example.com)

ಉದಾಹರಣೆ ವಿನಂತಿ

cURL
Python
JavaScript
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
  }
]

ಪ್ರತಿಕ್ರಿಯೆ ಕ್ಷೇತ್ರಗಳು

ಕ್ಷೇತ್ರ ಪ್ರಕಾರ ವಿವರಣೆ
uuid string Unique zone identifier (used in API requests)
domain string Domain name for this DNS zone
created_at datetime Zone creation timestamp (ISO 8601 format)
record_count integer Total number of DNS records in this zone

ಪ್ರತಿಕ್ರಿಯೆ ಸ್ಥಿತಿ ಕೋಡ್‌ಗಳು

200 Successfully retrieved DNS zones list
401 Unauthorized - Invalid or missing API token
403 Forbidden - Token lacks dns:list permission
ಪಡೆಯಿರಿ /api/v1/dns-zones/{uuid}/

DNS ಸವಲತ್ತು ವಿವರಗಳನ್ನು ಪಡೆದುಕೊಳ್ಳಿ

ಎಲ್ಲಾ ದಾಖಲೆಗಳನ್ನೊಳಗೊಂಡ ಒಂದು ನಿರ್ದಿಷ್ಟ DNS ವಲಯದ ವಿವರಗಳನ್ನು ಪಡೆದುಕೊಳ್ಳಿ.

ಮಾರ್ಗ ನಿಯತಾಂಕಗಳು

ಮಾಪನಾಂಕ ನಿರ್ಣಯ (ಕ್ಯಾಲಿಬ್ರೇಷನ್) ಪ್ರಕಾರ ಅಗತ್ಯವಿದೆ ವಿವರಣೆ
uuid string ಹೌದು Unique zone identifier

ಉದಾಹರಣೆ ಪ್ರತಿಕ್ರಿಯೆ

{
  "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"
    }
  ]
}

ಪ್ರತಿಕ್ರಿಯೆ ಸ್ಥಿತಿ ಕೋಡ್‌ಗಳು

200 Successfully retrieved zone details
404 Zone not found or not owned by user
ಪೋಸ್ಟ್ /api/v1/dns-zones/

DNS ವಲಯವನ್ನು ಸೃಷ್ಟಿಸು

ಒಂದು ಡೊಮೈನ್‌ಗಾಗಿ ಹೊಸ DNS ವಲಯವನ್ನು ನಿರ್ಮಿಸಿ. ವಲಯವನ್ನು ತಕ್ಷಣ VPS.org ಪರಿಚಾರಕಗಳಿಗೆ ಅಣಿಗೊಳಿಸಲಾಗುವುದು.

ವಿನಂತಿಯ ಮುಖ್ಯ ನಿಯತಾಂಕಗಳು

ಮಾಪನಾಂಕ ನಿರ್ಣಯ (ಕ್ಯಾಲಿಬ್ರೇಷನ್) ಪ್ರಕಾರ ಅಗತ್ಯವಿದೆ ವಿವರಣೆ
domain string ಹೌದು Domain name (e.g., example.com)

ಉದಾಹರಣೆ ವಿನಂತಿ

cURL
Python
JavaScript
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": []
}

ಪ್ರತಿಕ್ರಿಯೆ ಸ್ಥಿತಿ ಕೋಡ್‌ಗಳು

201 DNS zone created successfully
400 Bad Request - Invalid domain name or zone already exists
403 Forbidden - Token lacks dns:create permission
ಅಳಿಸಿ /api/v1/dns-zones/{uuid}/

DNS ವಲಯವನ್ನು ಅಳಿಸಿಹಾಕಿ

DNS ವಲಯವನ್ನೂ ಅದಕ್ಕೆ ಸಂಬಂಧಿಸಿದ ಎಲ್ಲಾ ದಾಖಲೆಗಳನ್ನೂ ಶಾಶ್ವತವಾಗಿ ಅಳಿಸಿ ಬಿಡುತ್ತದೆ. ಈ ಕ್ರಿಯೆಯನ್ನು ರದ್ದುಗೊಳಿಸಲಾಗುವುದಿಲ್ಲ.

ಮಾರ್ಗ ನಿಯತಾಂಕಗಳು

ಮಾಪನಾಂಕ ನಿರ್ಣಯ (ಕ್ಯಾಲಿಬ್ರೇಷನ್) ಪ್ರಕಾರ ಅಗತ್ಯವಿದೆ ವಿವರಣೆ
uuid string ಹೌದು Unique zone identifier

ಪ್ರತಿಕ್ರಿಯೆ ಸ್ಥಿತಿ ಕೋಡ್‌ಗಳು

204 Zone deleted successfully (no response body)
403 Forbidden - Token lacks dns:delete permission
404 Zone not found
ಪಡೆಯಿರಿ /api/v1/dns-zones/{uuid}/records/

ವಲಯದಲ್ಲಿ DNS ರೆಕಾರ್ಡ್‌ಗಳನ್ನು ಪಟ್ಟಿ ಮಾಡಿ

ಒಂದು ನಿಗದಿತ ವಲಯ (ನಿರ್ದೇಶಿತ ಮಾರ್ಗ) ಗೆ ಎಲ್ಲಾ DNS ದಾಖಲೆಗಳನ್ನು ಪಡೆದುಕೊಳ್ಳಿ.

ಮಾರ್ಗ ನಿಯತಾಂಕಗಳು

ಮಾಪನಾಂಕ ನಿರ್ಣಯ (ಕ್ಯಾಲಿಬ್ರೇಷನ್) ಪ್ರಕಾರ ಅಗತ್ಯವಿದೆ ವಿವರಣೆ
uuid string ಹೌದು Zone UUID

ಉದಾಹರಣೆ ವಿನಂತಿ

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"
  }
]
ಪೋಸ್ಟ್ /api/v1/dns-zones/{uuid}/records/

ವಲಯದಲ್ಲಿ DNS ರೆಕಾರ್ಡು ಅನ್ನು ಸೃಷ್ಟಿಸುName

ಒಂದು ನಿಗದಿತ ವಲಯಕ್ಕೆ (ನಿರ್ದಿಷ್ಟ ಮಾರ್ಗ) ಹೊಸ DNS ದಾಖಲೆಯನ್ನು ಸೇರಿಸು.

ವಿನಂತಿಯ ಮುಖ್ಯ ನಿಯತಾಂಕಗಳು

ಮಾಪನಾಂಕ ನಿರ್ಣಯ (ಕ್ಯಾಲಿಬ್ರೇಷನ್) ಪ್ರಕಾರ ಅಗತ್ಯವಿದೆ ವಿವರಣೆ
record_type string ಹೌದು Record type: A, AAAA, CNAME, MX, TXT, NS, SRV, CAA
name string ಹೌದು Record name (@ for root, subdomain, or FQDN)
value string ಹೌದು Record value (IP address, hostname, text)
ttl integer No Time to live in seconds (default: 3600)
priority integer For MX/SRV Priority (required for MX and SRV records)

ಉದಾಹರಣೆ ವಿನಂತಿ

cURL
Python
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())

ಪ್ರತಿಕ್ರಿಯೆ ಸ್ಥಿತಿ ಕೋಡ್‌ಗಳು

201 DNS record created successfully
400 Bad Request - Invalid parameters or validation error (e.g., MX record missing priority)
GET PUT PATCH DELETE /api/v1/dns-records/{uuid}/

DNS ದಾಖಲೆಗಳನ್ನು ವ್ಯವಸ್ಥಾಪಿಸಿ (ಡಿಜಿಟಲ್ ನಿಲುಕಣಾ) Name

ವೈಯಕ್ತಿಕ DNS ದಾಖಲೆಗಳಲ್ಲಿನ ಸಂಪೂರ್ಣ ಕ್ಷಮಾಯಾಚನೆಗಳು ನೋಂದಾಯಿಸುತ್ತವೆ.

ಲಭ್ಯವಿರುವ ಕಾರ್ಯಾಚರಣೆಗಳು

ಮನವಿ ಪ್ರಮಿತಿಗಳು (api/v/1/ dns/records ಗೆ)

Parameter ಪ್ರಕಾರ ವಿವರಣೆ
zone string Filter records by zone UUID
record_type string Filter by record type (A, AAAA, MX, etc.)

ಉದಾಹರಣೆ: ಒಂದು ದಾಖಲೆಪತ್ರದ 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

ಪ್ರಕಾರ Purpose Example Value Priority Required
A Maps domain to IPv4 address 192.0.2.1 ಇಲ್ಲ
AAAA Maps domain to IPv6 address 2001:0db8::1 ಇಲ್ಲ
CNAME Creates alias to another domain example.com ಇಲ್ಲ
MX Mail server for domain mail.example.com ಹೌದು
TXT Text record (SPF, DKIM, verification) v=spf1 include:_spf.google.com ~all ಇಲ್ಲ
NS Nameserver delegation ns1.example.com ಇಲ್ಲ
SRV Service location record 10 5060 sip.example.com ಹೌದು
CAA Certificate authority authorization 0 issue "letsencrypt.org" ಇಲ್ಲ

ಉತ್ತಮ ರೂಢಿಗಳು

TTL ಸಂರಚನೆ

ಸಾಮಾನ್ಯ ನಮೂನೆಗಳು

ಸುರಕ್ಷತೆ

ನಿರ್ವಹಿಸುವಾಗ ದೋಷ

ಸಾಮಾನ್ಯ ದೋಷಗಳು

ಸ್ಥಿತಿ ಕೋಡ್ ದೋಷ ಪರಿಹಾರ
400 ಅಮಾನ್ಯವಾದ ಡೊಮೈನ್ ಹೆಸರು DNS ನ ಹೆಸರಿಸಲಾದ ಅಧಿವೇಶನಗಳನ್ನು ಪ್ರತಿನಿಧೀಕರಿಸುವ ಡೊಮೈನ್
400 MX ದಾಖಲೆಗೆ ಆದ್ಯತೆ ಅಗತ್ಯವಿದೆ ಒಳಸೇರಿಸು priority MX ಹಾಗು SRV ದಾಖಲೆಗಳಿಗೆ (ಔಟ್ ಪುಟ್) ಸ್ಥಳ
401 ಅಮಾನ್ಯವಾದ API ಸಂಕೇತ ಸೂಚಕದ ವಿನ್ಯಾಸವನ್ನು ಗುರುತು ಹಾಕು (ಆರಂಭ ಮಾಡಬೇಕು) vps_)
403 ಅನುಮತಿಯು ಕಾಣಿಸುತ್ತಿಲ್ಲ ಅಗತ್ಯಪಡಿಸಲಾದಂತಹ ಹೊಸ ತಂತ್ರಾಂಶವನ್ನು ಉತ್ಪಾದಿಸು dns:* ಅನುಮತಿಗಳು
404 ವಲಯ/ರೇಡ್ ಕಂಡುಬಂದಿಲ್ಲ ನಿಮ್ಮ ಖಾತೆಯ UID ಹಾಗು ಸಂಪನ್ಮೂಲವನ್ನು ಪರಿಶೀಲಿಸಿ

ಉದಾಹರಣೆ ದೋಷComment

{
  "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

ಜಾಲತಾಣ ಉಪಕರಣಗಳನ್ನು ಬಳಸಲಾಗುತ್ತಿದೆ