VPS.org API

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

ಡೊಮೈನ್‌ಗಳು API

ಲಭ್ಯವಿರುವ ಡೊಮೈನ್ ಹೆಸರುಗಳು, ರೆಜಿಸ್ಟರು ಹಾಗು ಡೊಮೈನ್‌ಗಳನ್ನು ಅಪ್‌ಡೇಟ್ ಮಾಡು, ಹಾಗು ಅವುಗಳ ಹೆಸರು ಪರಿಚಾರಕಗಳು ಹಾಗು ಸ್ವಯಮಾಹಿತಿ. ಡೊಮೈನ್‌ಗಳನ್ನು ಅವರ uidಗಳಿಂದ ಗುರುತಿಸಲಾಗುತ್ತದೆ.

ಅಂತ್ಯಬಿಂದುಗಳು 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 ಡೊಮೈನ್ ರೆಜಿಸ್ಟರಾಗಿಸಿದಾಗ ಹಾಗು ಮುಗಿದಾಗ. ಸಮಯ ಕಳೆದಾಗ ದೋಷ ಉಂಟಾಗಿದೆ.recurrent_ dated is a defaultment
days_until_expiration integer | null ಅವಧಿ ತೀರಿಕೆ ಸಮಯ ಮೀರುವವರೆಗೂ ಪೂರ್ಣరోజుಗಳು, ಋಣಾತ್ಮಕ ಕಾಲವು ಮುಗಿದಿವೆ (_U)Engary free Sound
is_expired, needs_renewal_soon boolean Whether the domain has expired, and whether it expires within the next 30 days
auto_renew, renewal_period_years boolean, integer ಡೊಮೈನ್ ಸ್ವಯಂಆವೇಶಗೊಳ್ಳಬೇಕೆ ಹಾಗು ಎಷ್ಟು ವರ್ಷದಿಂದ ಇದನ್ನು ನವೀಕರಿಸಬೇಕೆ
registration_price, renewal_price string ಯುಎಸ್ಡಿ ನಲ್ಲಿ ದಶಮಾಂಶ ವಾಕ್ಯಗಳಾಗ (ಶೇರ್) ಬೆಲೆಗಳು
whois_privacy, transfer_lock boolean WHOIS privacy and registrar transfer lock settings
nameserver1 to nameserver4 string | null ಡೊಮೈನ್‌ನ ಹೆಸರು ಪರಿಚಾರಕಗಳು (ಸರ್ವರ್)
created_at, updated_at datetime ದಾಖಲೆಯನ್ನು ರಚಿಸಿ ಕೊನೆಗೆ ಬದಲಾಯಿಸಲಾದಾಗ (JS 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/

ಹುಡುಕು ಡೊಮೈನ್ ಅವಾಹ್ಯ

Checks whether a name is available across about 20 popular extensions (com, net, org, io, dev, co, app, ai and more), plus the extension you typed if it is not among them. Results start with the exact match, then available names, then taken ones.

ಅನುಮತಿಯ ಅಗತ್ಯವಿದೆ: domains:search

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

ಮಾಪನಾಂಕ ನಿರ್ಣಯ (ಕ್ಯಾಲಿಬ್ರೇಷನ್) ಪ್ರಕಾರ ಅಗತ್ಯವಿದೆ ವಿವರಣೆ
domain string ಹೌದು ಒಂದು ವಿಸ್ತರಣೆಯಿದ್ದ ಅಥವ ಏನಿಲ್ಲದ ಒಂದು ಹೆಸರು, ಉದಾಹರಣೆಗೆ missite.com (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
}

Prices are numbers in USD for one year and are null for names that are not available. The prices shown are illustrative.

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

200 ಯಶಸ್ವಿಯಾಗಿದೆ
400 ಕಾಣೆಯಾಗಿರುವ ಡೊಮೈನ್, ಅಥವಾ ಅದರಲ್ಲಿ ಅಕ್ಷರ, ಅಂಕಿಅಂಶಗಳು ಮತ್ತು ಹೈಫೇನ್‌ಗಳಲ್ಲದೆ ಬೇರೆ ಅಕ್ಷರಗಳಿವೆ
500 ರೆಜಿಸ್ಟ್ರಾರ್ ಹುಡುಕಾಟ ವಿಫಲವಾಯಿತು. ನಂತರ ಮರಳಿ ಪ್ರಯತ್ನಿಸಿ.
ಪೋಸ್ಟ್ /api/v1/domains/register/

ಹೊಸ ಡೊಮೇನ್ ನೋಂದಾಯಿಸಿ

ಒಂದು ಡೊಮೈನ್ ಹಾಗು ನೀವು ಉಳಿಸಿದ ಹಣವನ್ನು ಡೊಮೈನ್ ಮಾಡುವಿಕೆಯನ್ನು ಸೂಚಿಸುತ್ತದೆ. ಅವಾಹ್ಯತೆ ಮತ್ತು ಬೆಲೆ ವಿಶ್ಲೇಷಕದ ಮೊದಲು ರಿಜಿಸ್ಟರಿಯಿಂದ ಮರುಕಳಿಸಲ್ಪಡುತ್ತದೆ. ನಿಮ್ಮ ಖಾತೆಯ ಪ್ರೊಫೈಲ್ ನಿಂದ ನೋಂದಾಯದ ವಿವರಗಳನ್ನು ತೆಗೆಯಲಾಗುತ್ತದೆ. ರೆಜಿಸ್ಟರರು ನೋಂದಾಯಣಾವನ್ನು ನಿರಾಕರಿಸಿದರೆ, ಹಣವು ಮರುಕಳಿಸಲ್ಪಡುತ್ತದೆ.

ಅನುಮತಿಯ ಅಗತ್ಯವಿದೆ: domains:register ಡೊಮೈನ್‌ಗಳಿಂದ ವಿಭಾಜಿಸಲಾದ (ಡೊಮೈನ್‌ಗಳು: *)

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

ಮಾಪನಾಂಕ ನಿರ್ಣಯ (ಕ್ಯಾಲಿಬ್ರೇಷನ್) ಪ್ರಕಾರ ಅಗತ್ಯವಿದೆ ವಿವರಣೆ
domain string ಹೌದು ಸಂಪೂರ್ಣ ಕ್ಷೇತ್ರ ವಿಸ್ತರಣೆಯನ್ನು ಸೇರಿಸಿ, ಉದಾಹರಣೆಗೆ, comm.
years integer ಇಲ್ಲ MONTH ಕಾಲಾವಧಿ, 1 ಇಂದ ೧೦ (default 1). ಬೆಲೆಯು ವಾರ್ಷಿಕ ಮೊತ್ತದ ವರ್ಷಗಳಲ್ಲಿ ವರ್ಷಕ್ಕೆ ಎರಡು ವರ್ಷಗಳನ್ನು ಅಗತ್ಯವಾಗಿದೆ. ai ಕನಿಷ್ಟ 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 ಕಡತದಲ್ಲಿ ಯಾವುದೇ ಹಣಕಾಸು ವಿಧಾನವಿಲ್ಲ, ಅಥವಾ facts ನಲ್ಲಿ ಯಾವುದೇ ಬೆಂಬಲವಿಲ್ಲ
500 ಈ ಹಣವನ್ನು ಸಂಸ್ಕರಿಸಲು ಸಾಧ್ಯವಾಗಿಲ್ಲ, ಅಥವಾ ಬೆಲೆಯು ಸಲ್ಲಿಸಿದ ನಂತರ ರೆಜಿಸ್ಟರರ್ ಅದನ್ನು ನಿರಾಕರಿಸಿದನು. ಎರಡನೇ ಸಂದರ್ಭದಲ್ಲಿ, ದೋಷದ ಸಂದೇಶವು ಮರಳಿದೆಯೆ ಎಂದು ತಿಳಿಸುತ್ತದೆ.
ಪೋಸ್ಟ್ /api/v1/domains/{uuid}/renew/

ಡೊಮೈನ್‌ ಅನ್ನು ಮರಳಿ ನವೀಕರಿಸು

ಡೊಮೈನ್‌ ಅನ್ನು ಮರಳಿ ನವೀಕರಿಸಿ ಪ್ರತಿ ವರ್ಷಕ್ಕೆ ನೀವು ಉಳಿಸಿದ ಹಣಸಂಗ್ರಹ ವಿಧಾನಕ್ಕೆ ನವೀಕರಿಸಲಾಗಿದೆ.

ಅನುಮತಿಯ ಅಗತ್ಯವಿದೆ: domains:renew

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

ಮಾಪನಾಂಕ ನಿರ್ಣಯ (ಕ್ಯಾಲಿಬ್ರೇಷನ್) ಪ್ರಕಾರ ಅಗತ್ಯವಿದೆ ವಿವರಣೆ
years integer ಇಲ್ಲ ಸೇರಿಸಬೇಕಾದ ವರ್ಷಗಳು, 1 ರಿಂದ 10 ವರೆಗಿನ (ಪೂರ್ವನಿಯೋಜಿತ) 
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 ಹಣಸಂಗ್ರಹವನ್ನು ಕಾರ್ಯಗತಗೊಳಿಸಲಾಗಲಿಲ್ಲ, ಅಥವಾ ತೆರವು ಸಹ ಆ ಸಾಲವನ್ನು ಪಾವತಿಮಾಡಿತು. ಆದರೆ ನವೀಕರಣದ ವಿಫಲವಾಯಿತು.
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 ಹೌದು ಪ್ರಾಥಮಿಕ ಹೆಸರು ಪರಿಚಾರಕ (server) ಆತಿಥೇಯನಾಮ
nameserver2, nameserver3, nameserver4 string ಇಲ್ಲ ಹೆಚ್ಚುವರಿ ಹೆಸರು ಪರಿಚಾರಕ (hostname) hostnameಗಳು 
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 ಪರಿಚಾರಕದ (server) ೧ ಕಾಣೆಯಾಗಿದೆSocket error code NotBound
404 ಕಂಡು ಬಂದಿಲ್ಲ, ಅಥವಾ ಅದು ಬೇರೊಂದು ಖಾತೆಗೆ ಸೇರಿದ್ದಾಗಿದೆ
500 ಅಪ್ಡೇಟ್ ವಿಫಲಗೊಂಡಿದೆ; ದೇಹದಲ್ಲಿ ದೋಷವಿದೆ ಮತ್ತು ಸಂದೇಶದ ಕ್ಷೇತ್ರಗಳು ಇವೆ
PUT /api/v1/domains/{uuid}/auto-renew/

ಸ್ವಯಂ ಆರೋಹಿತಗೊಳ್ಳುವುದನ್ನು ಸ್ಥಗಿತಗೊಳಿಸು ಅಥವ ಸ್ಥಗಿತಗೊಳಿಸು

ಸ್ವಯಂ ನವೀಕರಣವನ್ನು ಹೊಂದಿಸಿ ಹಾಗು ಅಪ್‌ಡೇಟ್ ಮಾಡಲಾದ ವಸ್ತುವನ್ನು ಮರಳಿಸುತ್ತದೆ. JSON ಬೀಚ್ ಎಂದು ಶಕ್ತಗೊಂಡಿದೆ. ಒಂದು subsum is: ವಾಕ್ಯವನ್ನೊಳಗೊಂಡಿಲ್ಲದ ಯಾವುದೇ ವಾಕ್ಯವನ್ನೂ, ಸ್ವಯಂಚಾಲಿತವಾಗಿ- ರದ್ದು ಮಾಡುತ್ತದೆ.

ಅನುಮತಿಯ ಅಗತ್ಯವಿದೆ: 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 ಕಂಡು ಬಂದಿಲ್ಲ, ಅಥವಾ ಅದು ಬೇರೊಂದು ಖಾತೆಗೆ ಸೇರಿದ್ದಾಗಿದೆ

Notes