DNS മാനേജ്മെന്റ് API

അവലോകനം

DNS API ഡിഎന്‍എസ് സൈനുകളുടെയും രേഖകളുടെയും മുഴുവന്‍ മാനേജ്മെന്റ് ലഭ്യമാക്കുന്നു. എല്ലാ മേഖലകളും VPS.org-ന്റെ ആധികാരിക നാമ സേവകരാണ്. സ്വയമായി BIND9 മേഖല ഫയല്‍ ഓര്‍ഡര്‍, ഡീഫോള്‍ട്ടും.

നെയിം സര്‍വര്‍ ഇന്‍സ്റ്റാള്‍ ചെയ്യല്‍Name

ns1.vps.org (38.248.6.195) - DNSSEC- ഇന്‍ലൈന്‍ ഒപ്പിട്ട പ്രാഥമിക മാസ്റ്റര്‍
ns2.vps.org (38.248.6.196) - സെക്കന്‍ഡറി ദാസ്
ns3.vps.org (38.248.6.197) - സെക്കന്‍ഡറി ദാസ്

കീ വിശേഷതകള്‍

ഓട്ടോമാറ്റിക്കായി BIND9 മേഖലാ ഫയലും നിര്‍മ്മാണ സ്ഥാന നിര്‍മ്മാണവും
SIG ആധികാരികത ഉറപ്പാക്കുന്ന വഴി മേഖലയുടെ ട്രാന്‍സ്മിഷന്‍ (പ്രൊഫൈല്‍ അഡ്മിനിസ്ട്രേറ്റ്- അടിമസ്ട്രേഷന്‍)
എല്ലാ പ്രധാന DNS റെക്കോര്‍ഡ് തരങ്ങള്‍ക്കും പിന്തുണ (AAA, C, CNAME, MX, TXT, NXT, SRV, CAAA)
ഡൊമൈന്‍ നാമം ഫില്‍റ്റര്‍, UUID അടിസ്ഥാനമാക്കിയുള്ള മേഖല തിരിച്ചറിയല്‍
മേഖലാ- പ്രത്യേക റെക്കോര്‍ഡ് മാനേജ്മെന്റിനുള്ള നെറ്റ്‌വര്‍ക്ക് മാര്‍ഗ്ഗങ്ങള്‍Name

ആധികാരികത

എല്ലാ DNSPI അഭ്യര്‍ത്ഥനകളും റിക്കോര്‍ഡ് ആധികാരികത ഉറപ്പാക്കേണ്ടതുണ്ട്. നിങ്ങളുടെ അക്കൌണ്ടില്‍ നിന്നും API ഒബ്ജക്ട്സ് നിര്‍മ്മിക്കുക /account/developers/ താഴെപ്പറയുന്ന അനുവാദങ്ങളോടൊപ്പം:

dns:list - ഡിഎന്‍എസ് സൈനുകളും റെക്കോഡുകളും കാണുക
dns:create - പുതിയ മേഖലകളും രേഖകളും നിര്‍മ്മിക്കുക
dns:update - നിലവിലുള്ള മേഖലകളും നാള്‍വഴികളും മാറ്റുക
dns:delete - സൈനുകളും രേഖകളും നീക്കം ചെയ്യുക
dns:* - പൂര്‍ണ്ണ ഡിഎന്‍എസ് മാനേജ്മെന്റ് ആക്സസിബിള്‍

ഉദാഹരണം

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 സോണ്‍ നിര്‍മ്മിക്കുക. zone ഉടനടി 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/

ഡിഎന്‍എസ് റിക്കോര്‍ഡുകള്‍ മേഖലയില്‍ കാണിയ്ക്കുക

ഒരു പ്രത്യേക മേഖലയ്ക്കായി എല്ലാ ഡിഎന്‍എസ് റെക്കോര്‍ഡുകളും ലഭ്യമാക്കുക.

പാത പാരാമീറ്ററുകൾ

പരാമീറ്റര്‍	ടൈപ്പ് ചെയ്യുക	ആവശ്യമാണ്	വിവരണം
`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 റെക്കോര്‍ഡ് ഉണ്ടാക്കുക

ഒരു പ്രത്യേക മേഖലയിലേക്ക് ഒരു പുതിയ 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 റെക്കോര്‍ഡ്‌ റെക്കോര്‍ഡ്‌ ചെയ്തുകൊണ്ട് CRD ഓപ്പറേഷന്‍സ്.

ലഭ്യമായ പ്രവര്‍ത്തനങ്ങള്‍

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/recods)

Parameter	ടൈപ്പ് ചെയ്യുക	വിവരണം
`zone`	string	Filter records by zone UUID
`record_type`	string	Filter by record type (A, AAAA, MX, etc.)

ഉദാഹരണം: ഒരു റെക്കോര്‍ഡ്‌ ടിടിഐ പരിഷ്‌കരിക്കുക

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"	ഇല്ല

ഏറ്റവും നല്ല നടപടികള്‍

ടിടിഎല്‍ ക്രമീകരണം

നിര്‍മ്മാണം (stable): 3600-86,400 സെക്കന്റുകള്‍ (1-24 മണിക്കൂര്‍)
സ്ഥലം മാറുന്നതിനു് മുമ്പ്: 300-600 സെക്കന്റുകള്‍ (5- 10 മിനിട്ടുകള്‍) - നിര്‍ണ്ണയിക്കുന്നതിനു് മുമ്പ് കുറഞ്ഞ ടിടിഎല്‍
വികസനം: വേഗത്തിലുള്ള ടെസ്റ്റിനു് 300- 180 സെക്കന്റുകള്‍ (5- 30 മിനിട്ടുകള്‍)

സാധാരണ മാതൃകകള്‍

റൂട്ട് ഡൊമെയ്നുകള്‍ (@): A/ AA എ രേഖകള്‍ ഉപയോഗിക്കുക, C അല്ല.
www സബ്ടൊമൈന്‍: സി റൂട്ട് ചൂണ്ടിക്കാണിക്കാനോ അല്ലെങ്കില്‍ ഒരു റെക്കോര്‍ഡ് വേര്‍തിരിക്കുകയോ ചെയ്യുവാന്‍ സാധിക്കുന്നു
ഈമെയില്‍ (MX): എപ്പോഴും മുന്‍ഗണന ഉള്‍പ്പെടുത്തുക, താഴെ നമ്പര്‍ = കൂടിയ മുന്‍ഗണന നല്‍കുക
സിNAME OF TRANSLATORS ഒരേ പേരില്‍ റെക്കോര്‍ഡ് തരങ്ങള്‍ ചേര്‍ക്കാന്‍ സാധ്യമല്ല

സുരക്ഷിതത്വം

CAA രേഖകള്‍: സര്‍ട്ടിഫിക്കറ്റ് സര്‍ട്ടിഫിക്കറ്റുകള്‍ ഏത് CA- ല്‍ അപ്രതീക്ഷിതമായി വരുമെന്ന് വ്യക്തമാക്കുക
XSPK/DKMARC: ശബ്ദമുണ്ടാക്കാതിരിക്കാന്‍ ഈമെയില്‍ ആധികാരികത ഉറപ്പാക്കല്‍ ക്രമീകരിയ്ക്കുക
സാധാരണ അയഡിറ്റുകള്‍: ഉപയോഗിച്ചിട്ടില്ലാത്ത എന്‍ട്രികള്‍ നീക്കം ചെയ്യുക

കൈകാര്യം ചെയ്യുന്നതില്‍ പിശക്

സാധാരണ പിശകുകള്‍

സ്റ്റാറ്റസ് കോഡ്	പിശക്	പരിഹാരം
400	അസാധുവായ ഡൊമൈന്‍ നാമം	DNS പേരിടുന്ന കത്തുകള്‍ക്കു് ശേഷം പ്രാവര്‍ത്തിക ഡൊമൈന്‍സ് തുടരുന്നു
400	എം.എക്സ് റെക്കോര്‍ഡ് ആവശ്യമുണ്ട്	ഉള്‍പ്പെടുത്തുക `priority` എം.എക്സും എസ്. ആര്‍.വി റെക്കോഡുകളുംക്കുള്ള ഫീള്‍ഡ്
401	അസാധുവായ API അടയാളം	സൂചനയുടെ ഫോര്‍മാറ്റ് പരിശോധിക്കുക (തുടക്കത്തില്‍ തുടങ്ങേണ്ട) `vps_`)
403	അനുവാദം ലഭ്യമല്ല	ആവശ്യമായിരിക്കെ പുതിയ അടയാളം ഉണ്ടാക്കുക `dns:*` അനുമതികള്‍
404	മേഖല/റെക്കോഡ് ലഭ്യമല്ല	USE- ല്‍ നിന്നും ഉറപ്പാക്കുക, ഉറപ്പാക്കുക നിങ്ങളുടെ അക്കൗണ്ടില്‍ ഉള്‍‌ക്കൊള്ളുന്നു

ഉദാഹരണത്തിനു് മറുപടി നല്‍കുക

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

അവലോകനം

നെയിം സര്‍വര്‍ ഇന്‍സ്റ്റാള്‍ ചെയ്യല്‍Name

കീ വിശേഷതകള്‍

ആധികാരികത

ഉദാഹരണം

എല്ലാ DNS സോണുകളും ലിസ്റ്റുചെയ്യുക

അന്വേഷണ പാരാമീറ്ററുകൾ

ഉദാഹരണ അഭ്യർത്ഥന

ഉദാഹരണ പ്രതികരണം

പ്രതികരണ ഫീൽഡുകൾ

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

DNS സോണ്‍വര്‍ വിവരങ്ങള്‍ ലഭ്യമാക്കുക

പാത പാരാമീറ്ററുകൾ

ഉദാഹരണ പ്രതികരണം

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

DNS സോണ്‍ നിര്‍മ്മിക്കുക

ബോഡി പാരാമീറ്ററുകൾ അഭ്യർത്ഥിക്കുക

ഉദാഹരണ അഭ്യർത്ഥന

ഉദാഹരണ പ്രതികരണം

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

DNS സോണ്‍ നീക്കം ചെയ്യുക

പാത പാരാമീറ്ററുകൾ

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

ഡിഎന്‍എസ് റിക്കോര്‍ഡുകള്‍ മേഖലയില്‍ കാണിയ്ക്കുക

പാത പാരാമീറ്ററുകൾ

ഉദാഹരണ അഭ്യർത്ഥന

ഉദാഹരണ പ്രതികരണം

മേഖലയില്‍ DNS റെക്കോര്‍ഡ് ഉണ്ടാക്കുക

ബോഡി പാരാമീറ്ററുകൾ അഭ്യർത്ഥിക്കുക

ഉദാഹരണ അഭ്യർത്ഥന

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

DNS റെക്കോര്‍ഡുകള്‍ കൈകാര്യം ചെയ്യുക (ഡിറക്റ്റ് ആക്സസിബിള്‍)

ലഭ്യമായ പ്രവര്‍ത്തനങ്ങള്‍

ചോദ്യം പരാമീറ്ററുകള്‍ (ലാന്‍ഡ്/api/v/1/ dns/recods)

ഉദാഹരണം: ഒരു റെക്കോര്‍ഡ്‌ ടിടിഐ പരിഷ്‌കരിക്കുക

Supported DNS Record Types

ഏറ്റവും നല്ല നടപടികള്‍

ടിടിഎല്‍ ക്രമീകരണം

സാധാരണ മാതൃകകള്‍

സുരക്ഷിതത്വം

കൈകാര്യം ചെയ്യുന്നതില്‍ പിശക്

സാധാരണ പിശകുകള്‍

ഉദാഹരണത്തിനു് മറുപടി നല്‍കുക

DNS മാറ്റങ്ങള്‍ പരിശോധിക്കുന്നു

റിക്കോര്‍ഡ് പ്രൊഫെഷണല്‍ ഉറപ്പാക്കുക

ഓണ്‍ലൈന്‍ ടൂള്‍ ഉപയോഗിക്കുന്നു