VPS.org API

టెక్స్టు API పత్రికీకరణQuery

డొమైన్లుAPI

అందుబాటులో డొమైన్ నామములు, రిజిస్టర్లు మరియు డొమైన్లు కొరకు శోధించుము, మరియు వాటి పేరు Syncs మరియు స్వయంచాలక- religi- ను నిర్వహించుము. డొమైన్స్ వాటి 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 డొమైన్ నిర్వహించబడుతున్న Regier
registration_date, expiration_date datetime డొమైన్ రిజిష్టర్ నిర్వహించబడినప్పుడు మరియు అది శరదృతువువగానే వుంటుంది.reason_ dates. default device
days_until_expiration integer | null కాలంచెల్లేవరకు పూర్తిరోజులు(_D)ESendOptionsAfter
is_expired, needs_renewal_soon boolean డొమైన్ ఆపివేయబడి ఆగివుందా మరియు అది తరువాత 30 రోజుల లోపల ఆగి తెల్పబడుతుందో
auto_renew, renewal_period_years boolean, integer డొమైన్ స్వయంచాలకంగా నవీకరించబడాలా, మరియు యెన్ని సంవత్సరాలకు
registration_price, renewal_price string USD లోని విలువలు దశాంశ స్ట్రింగ్స్
whois_privacy, transfer_lock boolean ఎన్విరాన్మెంట్ మరియు రిజిస్ట్రేషన్ లాక్ అమర్పులుComment
nameserver1 to nameserver4 string | null డొమైన్ యొక్క పేరు సేవికలు
created_at, updated_at datetime రిపోర్టు సృష్టించబడి చివరిగా మార్చబడినప్పుడు (JIS 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 అవును ఒక పొడిగింపుతో లేదా నిదానముతో ఒక పేరు, ఉదాహరణకు Musicoid లేదా myusite.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
}

అయితే, ఆ పేరుకు ఉన్న విలువను ఆ పేరుకు తగ్గట్లు ముడిపెట్టాలి.

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

200 సఫలం
400 తప్పిపోయిన డొమైన్, లేదా దానిలో అక్షరాలు, సంఖ్యలు, మరియు హైఫిన్లు తప్ప మరే అక్షరాలు ఉన్నాయి
500 రిజిస్ట్రర్ చూడుట విఫలమైంది. తరువాత మళ్ళీ ప్రయత్నించుము.
పెరా /api/v1/domains/register/

కొత్త డొమైన్‌ను నమోదు చేయండి

ఒక డొమైన్ రిజిస్ట్రేషన్ మరియు మీరు దాచిన చెల్లింపు పద్దతి ని కారణమౌతున్నాయి. ఎగ్జిక్యూటివ్ నిమిషనము ముందు ఎగ్జిక్యూటబుల్‌తో అచేతనంగా సరిపోతుంది. మీరు ఎకౌంట్‌ను సంప్రదించినప్పటికి నిస్సారమైన సమాచారాన్ని మీ ఎక్‍స్పెండ్‌మెంట్‌నుండి తీసివేస్తే. రిజిస్ట్రేషన్ రిజిస్ట్రేషన్ ని తిరస్కరించినతర్వాత, అప్పు నిస్పాసిష్టాంశం తిరిగి పోతుంది.

అనుమతించు: domains:register (ఆర్థరస్ ద్వారా విస్తరించినది: *)

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

పెరామీటరు రకం అవసరం విశదీకరణము
domain string అవును ఉదాహరణకు, acm ను చేర్చిన మొత్తం డొమైన్ నామము
years integer వద్దు Registration period, 1 to 10 (default 1). The price is the yearly price times years. .ai requires at least 2 years; a smaller value returns 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/

డొమైన్‌ని పునఃప్రారంభించు

డొమైన్‌ను పునఃప్రారంభిస్తుంది మరియు అది మీరు దాచిన చెల్లింపు పద్ధతికి ప్రతి సంవత్సరం నవీకరణ_prick(prict) ను ఆకృతిచేస్తుంది.

అనుమతించు: 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 అదనంగా చెల్లించిన డబ్బును మార్చలేకపోయింది లేదా అప్పు తగ్గింది, కానీ రివ్యూ ప్రొఫైల్ రీసెర్చ్‌ విఫలమైంది.
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/

స్వయం- తిరిగి-ని ఆఫ్ చేయుము

స్వయంచాలకంగా నవీకరించబడిన డొమైన్ బ్రస్‌వలె చేతనం చేయబడినది మరియు తిరిగివుంచుము. SVN వలె చేతనమైనది: స్ట్రిక్‌-నిర్వహించిన, దోషముతో కలుపుకొని స్వయంచాలక-నిర్మినౌంట్‌ను-ని ప్రారంభించుము.

అనుమతించు: 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 దొరకలేదు, లేక మరొక ఖాతాకి చెందినది అదిలేదు

వ్యాఖ్యలు