VPS.org API

പരിശോധന എപിഐ സഹായക്കുറിപ്പുകള്‍Query

ഡൊമെയ്നുകള്‍ API

ലഭ്യമായ ഡൊമെയ്നുകളുടെ പേരുകള്‍, രജിസ്റ്റര്‍, പരിഷ്കരിയ്ക്കുക എന്നിവയ്ക്കായി തെരയുക, അവരുടെ പേരു് സേവകന്മാരെയും യാന്ത്രിക- റീറ്റൊണല്‍ എന്നിവയ്ക്കായി കൈകാര്യം ചെയ്യുക. മണ്ഡലങ്ങളെ അവരുടെ യൂയുഐഡി (uuid) ഉപയോഗിച്ച് തിരിച്ചറിയുന്നു.

എൻഡ്‌പോയിന്റുകൾ 7
ബേസ് പാത്ത് /api/v1/domains
നേടുക /api/v1/domains/

എല്ലാ ഡൊമെയ്‌നുകളും ലിസ്റ്റുചെയ്യുക

നിങ്ങളുടെ അക്കൌണ്ടില്‍ രേഖപ്പെടുത്തിയ ഡൊമെയ്നുകള്‍ തിരികെ നല്‍കുന്നു, ഓരോ താളിലും 25 പേരാണു്. പട്ടികയില്‍ ഫില്‍റ്ററുകള്‍ ഇല്ല.

അനുവാദം ആവശ്യമുണ്ട്: domains:list

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

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for domain in response.json()["results"]:
    print(domain["domain_name"], domain["status"], domain["expiration_date"])
const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

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

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
      "domain_name": "example.com",
      "status": "active",
      "registrar": "dynadot",
      "registration_date": "2026-01-15T10:30:00Z",
      "expiration_date": "2027-01-15T10:30:00Z",
      "days_until_expiration": 122,
      "is_expired": false,
      "needs_renewal_soon": false,
      "auto_renew": true,
      "renewal_period_years": 1,
      "registration_price": "12.64",
      "renewal_price": "12.64",
      "whois_privacy": true,
      "nameserver1": "ns1.vps.org",
      "nameserver2": "ns2.vps.org",
      "nameserver3": "ns3.vps.org",
      "nameserver4": null,
      "transfer_lock": true,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-09-01T08:12:40Z"
    }
  ]
}

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

ഫീള്‍ഡ് ടൈപ്പ് ചെയ്യുക വിവരണം
uuid string മറ്റ് ഡൊമൈന്‍ അറ്റാക്ക്മെന്റുകള്‍ക്കുളള ഡൊമൈന്‍ തിരിച്ചറിയല്‍ തിരിച്ചറിയല്‍ ബിന്ദു
status string active, pending, expired, cancelled, transferred
registrar string മണ്ഡലം പുന:സൃഷ്ടിച്ചുകൊണ്ടിരിയ്ക്കുന്നു
registration_date, expiration_date datetime ഡൊമെയ്നുകള്‍ രജിസ്റ്റര്‍ ചെയ്തതും അത് തീരുന്നതും ആയപ്പോള്‍. കാലാവധി_നാള്‍വിവരണം നിര്‍ജ്ജീവമാകാം.
days_until_expiration integer | null കാലാവധി അവസാനിക്കുന്നത് _ഒന്നു് അവസാനിക്കുന്നത് വരെയുള്ള ദിവസം,, _കെഗറന്‍സ് അവസാനിച്ച ശേഷം
is_expired, needs_renewal_soon boolean ഡൊമെയ്നിന്റെ കാലാവധി കഴിഞ്ഞോ, അടുത്ത 30 ദിവസത്തിനുള്ളില്‍ അതു് അവസാനമാണോ എന്നും
auto_renew, renewal_period_years boolean, integer ഡൊമെയ്നുകള്‍ യാന്ത്രികമായി പുതുക്കണമോ, എത്ര വര്‍ഷങ്ങള്‍ക്കു്
registration_price, renewal_price string യുഎസ്ഡി- ലെ വിലകള്‍ ദശാംശ സ്ട്രിങ്
whois_privacy, transfer_lock boolean DGI സ്വകാര്യതയും റെജിസ്റ്റര്‍ ട്രാന്‍സ്ഫര്‍ ലോക്ക് സജ്ജീകരണങ്ങളും
nameserver1 to nameserver4 string | null ഡൊമെയ്നിന്റെ പേരു് സേവകര്‍
created_at, updated_at datetime When the record was created and last changed (ISO 8601, UTC)
നേടുക /api/v1/domains/{uuid}/

ഡൊമെയ്നുകളുടെ വിശദാംശങ്ങള്‍ ലഭ്യമാക്കുക

ഒരു ഡൊമെയ്നുകള്‍ മുകളിലുള്ള ഫീള്‍ഡുകളുമായി തിരികെ കൊണ്ടുവരുന്നു.

അനുവാദം ആവശ്യമുണ്ട്: domains:list

curl -X GET "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

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

200 വിജയം
404 ഇല്ല, അല്ലെങ്കില്‍ മറ്റൊരു പ്രമാണം മാത്രമേ അവര്‍ക്ക് ലഭിക്കുകയുള്ളൂ.
പോസ്റ്റ് /api/v1/domains/search/

തെരച്ചില്‍ ഡൊമെയ്നു് അവതാര്യത

ജനീകൃതമായ 20 എക്സ്റ്റെന്‍ഷനുകള്‍ (കോമ, നെറ്റ്‌, ഗ്നോ, i, ഡീ, കോ, ആപ്, ആപ്, അമേ എന്നിവയോടൊപ്പം ഇതിലില്ലെങ്കില്‍ ടൈപ്പ് ചെയ്തിരിക്കുന്ന എക്സ്റ്റന്‍ഷനുകള്‍ ലഭ്യമാണോയെന്നു് പരിശോദിയ്ക്കുന്നു. ഫലങ്ങള്‍ ശരിയായ പൊരുത്തത്തോടെ തുടങ്ങുന്നു, പിന്നെ ലഭ്യ‌മായ പേരുകള്‍ ലഭ്യമാകുന്നു.

അനുവാദം ആവശ്യമുണ്ട്: domains:search

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

പരാമീറ്റര്‍ ടൈപ്പ് ചെയ്യുക ആവശ്യമാണ് വിവരണം
domain string അതെ ഒരു എക്സ്റ്റെന്‍ഷന്‍ ഉണ്ടെങ്കില്‍ അല്ലെങ്കില്‍ അതിനു് ഉദാഹരണം, മൈസ്തിറ്റോ മൈസ്തിറ്റോ. കോം (2 മുതല്‍ 63 അക്ഷരങ്ങള്‍)

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

cURL
Python
curl -X POST "https://admin.vps.org/api/v1/domains/search/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.com"}'
import requests

url = "https://admin.vps.org/api/v1/domains/search/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.post(url, headers=headers, json={"domain": "mysite.com"})
for result in response.json()["results"]:
    if result["available"]:
        print(result["domain"], result["registration_price"], result["renewal_price"])

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

{
  "results": [
    {
      "domain": "mysite.com",
      "available": false,
      "price": null,
      "registration_price": null,
      "renewal_price": null,
      "tld": "com",
      "is_exact_match": true
    },
    {
      "domain": "mysite.dev",
      "available": true,
      "price": 17.24,
      "registration_price": 17.24,
      "renewal_price": 17.24,
      "tld": "dev",
      "is_exact_match": false
    }
  ],
  "base_domain": "mysite",
  "search_count": 20
}

വിലകൾ യുഎസ്‌ഡി - ൽ ഒരു വർഷത്തേക്ക് എണ്ണപ്പെട്ടിട്ടുണ്ട്.

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

200 വിജയം
400 ലഭ്യമല്ലാത്ത ഡൊമെയ്നുകള്‍, അല്ലെങ്കില്‍ അക്ഷരങ്ങള്‍, അക്കങ്ങള്‍, ഹിഫിന്‍ എന്നിവ ഒഴികെയുള്ള ചിഹ്നങ്ങള്‍ അതില്‍ ഉണ്ട്
500 റെജിസ്റ്ററന്‍ തിരച്ചിലില്‍ പരാജയപ്പെട്ടു, പിന്നീട് വീണ്ടും ശ്രമിക്കുക.
പോസ്റ്റ് /api/v1/domains/register/

പുതിയ ഡൊമെയ്ൻ രജിസ്റ്റർ ചെയ്യുക

ഒരു ഡൊമെയ്നറി രേഖപ്പെടുത്തി നിങ്ങള്‍ സൂക്ഷിച്ചിട്ടുള്ള പാത്ത് ഫോര്‍മുല നിര്‍ദ്ദേശിക്കുന്നു. ചാര്‍ജ്ജ് ചെയ്യുന്നതിനു് തൊട്ടുമുന്‍പ് തന്നെ അവതാര്യവും വിലയും പരിശോധിയ്ക്കപ്പെടുന്നു. നിങ്ങളുടെ അക്കൌണ്ടിന്റെ പ്രൊഫൈല്‍ റിസപ്റ്ററിനല്‍ ഇന്‍ഫൊട്ട് ചെയ്തിരിയ്ക്കുന്നു. ഈ റെജിസ്റ്ററന്‍ ചെയ്തതിനു് ശേഷം റജിസ്റ്റര്‍ ചെയ്യുകയാണെങ്കില്‍, പൈസ നല്‍കല്‍ പൂര്‍ത്തിയായി നല്‍കുന്നു.

അനുവാദം ആവശ്യമുണ്ട്: domains:register ( ഡൊമൈനുകള്‍ ശേഖരിച്ചു്: *)

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

പരാമീറ്റര്‍ ടൈപ്പ് ചെയ്യുക ആവശ്യമാണ് വിവരണം
domain string അതെ ഉദാഹരണത്തിനു്, കോമപറ പൂര്‍ണ്ണ ഡൊമൈന്‍ നാമം ഉള്‍പ്പെടുത്തുക.
years integer ഇല്ല ക്യാപ് സമയം, 1 മുതല്‍ 10 വരെ (default 1). വിലയാണ് വര്‍ഷത്തിന്റെ വില. i, കുറഞ്ഞത് 2 വര്‍ഷമെങ്കിലും വേണം; ചെറിയ വില 400 ആവര്‍ത്തിയ്ക്കാണു്. 
curl -X POST "https://admin.vps.org/api/v1/domains/register/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.dev", "years": 1}'

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

{
  "success": true,
  "domain_uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
  "domain_name": "mysite.dev",
  "message": "mysite.dev registered successfully!"
}

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

201 ഡൊമെയ്നു് രജിസ്ടര്‍
400 അസാധുവായ ഡൊമൈന്‍, ഡൊമൈന്‍ എന്നിവ ലഭ്യമല്ല, വില ഉറപ്പാക്കുവാന്‍ സാധ്യമല്ല, കാലിയായുള്ള പണത്തിന്റെ രീതി അല്ലെങ്കില്‍ പേയ്മെന്റ് പരാജയപ്പെട്ടിരിക്കുന്നു
402 ഫയലില്‍ പണ രീതിയില്ല, പ്ളഗറുകളില്‍ ലഭ്യമല്ല
500 പൈസ പ്രവര്‍ത്തിക്കുവാന്‍ സാധ്യമല്ല, അല്ലെങ്കില്‍ പണത്തിനു ശേഷം രജിസ്ട്രേഷന്‍ നിഷേധിച്ചിട്ടില്ല. രണ്ടാമത്തെ കേസില്‍ പിശകിന്റെ സന്ദേശം പറയുന്നു, റിക്കോര്‍ഡ് ചെയ്തിട്ടുണ്ടോ എന്നു്.
പോസ്റ്റ് /api/v1/domains/{uuid}/renew/

ഒരു ഡൊമെയ്നു് വീണ്ടും തുടങ്ങുക

ഡൊമെയ്നുകള്‍ പുനര്‍നിര്‍ണ്ണയിക്കുകയും ഓരോ വര്‍ഷവും നിങ്ങള്‍ സൂക്ഷിച്ചിട്ടുള്ള പണ രീതിയില്‍ പുതുക്കിപ്പണിയുകയും ചെയ്യുന്നു.

അനുവാദം ആവശ്യമുണ്ട്: domains:renew

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

പരാമീറ്റര്‍ ടൈപ്പ് ചെയ്യുക ആവശ്യമാണ് വിവരണം
years integer ഇല്ല ചേര്‍ക്കാന്‍ വര്‍ഷങ്ങള്‍, 1 മുതല്‍ 10 വരെ (முன்னிருப்ப് 1) 
curl -X POST "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/renew/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"years": 1}'
{
  "success": true,
  "domain_uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
  "new_expiration": "2028-01-15T10:30:00+00:00",
  "message": "example.com renewed successfully for 1 year(s)!"
}

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

200 ഡൊമെയ്നു് പുതുക്കിയിരിയ്ക്കുന്നു
400 തെറ്റായ വര്‍ഷങ്ങള്‍, ഡൊമൈനിനു് പുനര്‍നിര്‍മ്മിക്കല്‍ വിലയില്ല, പണവും നല്‍കുവാന്‍ സാധ്യമല്ല, അല്ലെങ്കില്‍ പണവും പരാജയപ്പെട്ടു
404 ഇല്ല, അല്ലെങ്കില്‍ മറ്റൊരു പ്രമാണം മാത്രമേ അവര്‍ക്ക് ലഭിക്കുകയുള്ളൂ.
500 Payment could not be processed, or the payment went through but the registrar renewal failed. Contact support in that case.
PUT /api/v1/domains/{uuid}/nameservers/

നെയിം സര്‍വര്‍ പരിഷ്കരിക്കുക

Sets the domain's nameservers at the registrar and returns the updated domain object. To manage DNS with the DNS API, use ns1.vps.org, ns2.vps.org and ns3.vps.org and create a zone for the domain.

അനുവാദം ആവശ്യമുണ്ട്: domains:update

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

പരാമീറ്റര്‍ ടൈപ്പ് ചെയ്യുക ആവശ്യമാണ് വിവരണം
nameserver1 string അതെ പ്രൈമറി പേരു് സേവര്‍ ഹോസ്റ്റിന്റെ പേര്
nameserver2, nameserver3, nameserver4 string ഇല്ല കൂടുതല്‍ പേരിന്റെ സര്‍വര്‍ ഹോസ്റ്റിന്റെ പേര് 
curl -X PUT "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/nameservers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"nameserver1": "ns1.vps.org", "nameserver2": "ns2.vps.org", "nameserver3": "ns3.vps.org"}'

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

200 പേരു് സേവകര്‍ പരിഷ്കരിച്ചിരിക്കുന്നു; ശരീരം മണ്ഡലവസ്തു
400 പേര് സേവകന്‍1 ലഭ്യമല്ല
404 ഇല്ല, അല്ലെങ്കില്‍ മറ്റൊരു പ്രമാണം മാത്രമേ അവര്‍ക്ക് ലഭിക്കുകയുള്ളൂ.
500 പരിഷ്കരിച്ചിരിക്കുന്നു; ശരീരത്തില്‍ പിശകുണ്ടു്, സന്ദേശ ഫീള്‍ഡുകള്‍ ലഭ്യമാണ്
PUT /api/v1/domains/{uuid}/auto-renew/

സ്വയം _പുതുക്കുക അല്ലെങ്കില്‍ ഓഫ് ചെയ്യുക

സ്വയം പുതുക്കിയ ഡൊമെയ്നുകള്‍_ന്യൂഷന്‍ ആയി_തുറക്കുക. JSON ബൂളിയന്‍ ആയി പ്രവര്‍ത്തന സജ്ജീകരിച്ചിരിയ്ക്കുന്നു. ശൂന്യമായ സ്ട്രിങ് ഉള്‍‌ക്കൊള്ളുന്ന സ്ട്രിങ് ല്‍, അക്ഷരം ഉള്‍പ്പെടുന്ന സ്വയമായ ശൂന്യമായ സ്ട്രിങ് പ്രവര്‍ത്തന രഹിതമാക്കുക.

അനുവാദം ആവശ്യമുണ്ട്: domains:update

curl -X PUT "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/auto-renew/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

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

200 സൂക്ഷിച്ചതു്; ശരീരം മണ്ഡലവസ്തു
400 പ്രവര്‍ത്തന സജ്ജം ലഭ്യമല്ല
404 ഇല്ല, അല്ലെങ്കില്‍ മറ്റൊരു പ്രമാണം മാത്രമേ അവര്‍ക്ക് ലഭിക്കുകയുള്ളൂ.

കുറിപ്പുകള്‍