DNS నిర్వహణ API

అవలోకనం

DNSAPI DNS మండలాలు మరియు రికార్డులను పూర్తి నిర్వహణను అందిస్తుంది. అన్ని imers VPS.org యొక్క అధికారికమైన పేరు సర్వర్‌లు వుద్భవింపచేయబడిన ఉంటాయి స్వయంచాలక BIND9 జాంబ్ ఫైల్ ఉద్భవం మరియు కంప్రత్యక్షత.

నెట్వర్క్ ఇంటర్ ఫెస్ డాటా ఇంస్టెంట్Comment

ns1.vps.org (38.248.6.195) - PRENSESE- ఇన్‌సైన్‌తో ప్రాధమిక మాస్టర్
ns2.vps.org (38.248.6.196) - రెండవ బానిస
ns3.vps.org (38.248.6.197) - రెండవ బానిస

కీ సౌలభ్యాలు

స్వయంచాలకంగా BIND9 జోన్ ఫైల్ మరియు అనుసంధానము
TSG దృవీకరణ ద్వారా జోన్ బైనరీలు (బార్- 60)
అన్ని ప్రధాన DNS రికార్డు రకములకు మద్ధతిస్తుంది (AAA, C, C, MX, TXT, NS, SRV, CAA)
డొమైన్ నామము ఫిల్టర్ మరియు UUID ఆధారిత జోన్ గుర్తింపుName
జోన్- ప్రత్యేక రికార్డు నిర్వహణ కొరకు నెట్టు దారులు

ప్రామాణీకరణ

అన్ని DNSPI అభ్యర్ధనలకు సంక్షించటాన్ని అవసరం. మీ ఖాతాల నుండి APIపత్రాలను సృష్టించండి /account/developers/ ఈ క్రింది అనుమతులు తో:

dns:list - DNS సైజులను మరియు రికార్డులను చూడు
dns:create - కొత్త సైజులను మరియు రికార్డులను సృష్టించుము
dns:update - ప్రస్తుత వున్న సైజులను మరియు రికార్డులను సవరించుము
dns:delete - సైజులను మరియు రికార్డులను తొలగించుము
dns:* - పూర్తి DNS నిర్వహణ యాక్సెస్

ఉదాహరణలు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 రికార్డ్లను నిర్వహించు (నిర్దిష్ట యాక్సెస్)

DNS రికార్డింగులను ఉపయోగించి ప్రతి DNS రికార్డింగులు పూర్తి CRIS కార్యకలాపాలు.

అందుబాటులొ వున్న కార్యాలు

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

ప్రశ్న పారామిలిటరీలు (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 ఆకృతీకరణ

తృతీయ (stable): 3600-86,400 సెకన్లు (1- 24 గంటలు)
(R) బదిలీకరణ ముందు: 300-600 సెకన్లు (5- 10 నిమిషాలు) - ప్రణాళికలు మార్చుటకు ముందుగా దిగువ TTL
డెవలప్ మెంట్: వేగవంతమైన పరీక్ష కొరకు 300-180 సెకనులు (5- 30 నిమిషాలు)

ఉమ్మడి రూపకల్పనలు

రూట్ డొమైన్ (@): AA రికార్డ్సును వుపయోగించుము, సి కాదుNAME OF TRANSLATORS
www ఉపశీర్షిక: True ను వుపయోగించవచ్చుNAME OF TRANSLATORS
ఈమెయిల్ (MX): ఎల్లప్పుడు ప్రాధాన్యత, తక్కువ సంఖ్య = అధిక ప్రాధాన్యతను చేర్చుము
సిNAME OF TRANSLATORS ఇతర రికార్డు రకములు ఒకే పేరుకు చేరుకోలేక పోయాను

భద్రత

CAA రికార్డ్స్: ఏ CAS ధృవ పత్రములు డెమోన్ కాగలదో తెలుపుము
జిప్సీ/DIMARC: అప్రవేశంను నిరోధించుటకు ఈమెయిల్ ధృవీకరణను ఆకృతీకరించుము
సాధారణ ఆడిట్స్: ఉపయోగించని ప్రవేశములను తొలగించండి

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

ఉమ్మడి దోషములు

స్థితి కోడ్	దోషము	పరిష్కారం
400	సరికాని డొమైన్ పేరు	DNS పేరు పెట్టు సమావేశాలను అనుసరించుచున్నది
400	MX రికార్డు ప్రాముఖ్యత అవసరమైంది	జోడించు `priority` MX మరియు SRV రికార్డుల కొరకు పట్టీ
401	చెల్లని API గుర్తు	సూచన ఫార్మాట్‌ను పరిశీలించుము (ఆరంభించి ప్రారంభించాలి) `vps_`)
403	అనుమతి లేదు	అవసరమైనదానితో కొత్త సూచనను సృష్టించుము `dns:*` అనుమతులు
404	జోన్/ఉపయోగం కనబడలేదు	మీ లెక్కలోని UIDని పరిశీలించండి మరియు ధ్రువీకరించండి

ఉదాహరణలు దోషము

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

VPS.org API

DNS నిర్వహణ API

అవలోకనం

నెట్వర్క్ ఇంటర్ ఫెస్ డాటా ఇంస్టెంట్Comment

కీ సౌలభ్యాలు

ప్రామాణీకరణ

ఉదాహరణలుComment

అన్ని DNS జోన్‌లను జాబితా చేయండి

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

ఉదాహరణ అభ్యర్థన

ఉదాహరణ ప్రతిస్పందన

ప్రతిస్పందన ఫీల్డ్‌లు

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

DNS జోన్ వివరాలు పొందుము

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

ఉదాహరణ ప్రతిస్పందన

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

DNS జోన్‌ను సృష్టించుము

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

ఉదాహరణ అభ్యర్థన

ఉదాహరణ ప్రతిస్పందన

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

DNS జోన్ తొలగించు

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

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

జోన్‌లో DNS రికార్డ్స్ జాబితా

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

ఉదాహరణ అభ్యర్థన

ఉదాహరణ ప్రతిస్పందన

జోన్‌నందు DNS రికార్డ్‌ను సృష్టించుముName

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

ఉదాహరణ అభ్యర్థన

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

DNS రికార్డ్లను నిర్వహించు (నిర్దిష్ట యాక్సెస్)

అందుబాటులొ వున్న కార్యాలు

ప్రశ్న పారామిలిటరీలు (api/v/1/ dns/records కోసం)

ఉదాహరణ: ఒక రికార్డింగరు యొక్క TTL నవీకరణ

Supported DNS Record Types

ఉత్తమ ఆచారాలు

TTL ఆకృతీకరణ

ఉమ్మడి రూపకల్పనలు

భద్రత

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

ఉమ్మడి దోషములు

ఉదాహరణలు దోషము

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

రికార్డ్ ప్రెసిషన్‌ను పరిశీలించుము

ఆన్‌లైన్ సాధనములను ఉపయోగించు