ዶሜን

አግኝ /api/v1/domains/

ሁሉንም ጎራዎች ዘርዝር

Returns the domains registered in your account, 25 per page. The list has no filters.

የፈቃድ መጠን: 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	Domain identifier used in the other domain endpoints
`status`	string	`active`, `pending`, `expired`, `cancelled`, `transferred`
`registrar`	string	የዶሜይን ስም
`registration_date`, `expiration_date`	datetime	When the domain was registered and when it expires. expiration_date can be null.
`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	የWHOIS የግል መረጃና የመዝገብ ቤት ማስተላለፊያ መክፈቻዎች
`nameserver1` to `nameserver4`	string \| null	የዶሜን ስም ሰርቨሮች
`created_at`, `updated_at`	datetime	መዝገብ ቤትን መፍጠር እና ለመጨረሻ ጊዜ ማሻሻል (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 የሚበልጡ የተለመዱ ተጨማሪዎች (com, net, org, io, dev, co, app, ai እና ሌሎች) ውስጥ መኖሩን ያረጋግጣል፣ ከእነዚህ ውስጥ ካልሆነ ደግሞ የጻፍክትን ተጨማሪ ያረጋግጣል። ውጤቶች በቅጡ የሚመሳሰሉ ከሆነ ይጀምራሉ፣ ከዚያም የተሟሉ ስሞች፣ ከዚያም የተወሰዱት ናቸው።

የፈቃድ መጠን: domains:search

የጥያቄ አካል መለኪያዎች

መለኪያ	አይነት	ያስፈልጋል	መግለጫ የለም
`domain`	string	አዎ	ስም ከስፋት ጋር ወይም ያለስፋት, ለምሳሌ mysite ወይም mysite.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	ሪጅስትሪ ፈልግ miss.

ደብዳቤ /api/v1/domains/register/

አዲስ ዶሜይን ይመዝገቡ

ዶሜይንን ይመዝግቡ እና የተጠበቀውን የክፍያ ዘዴዎን ይከፍሉ. መኖሩና ዋጋው ከክፍያ በፊት በሪጅስትራሩ ጋር ይመረመራሉ. የሪጅስትራሩ የይገናኛ መረጃ ከሂሳብዎ ፕሮፊል ይወሰዳል. ሪጅስትራሩ ከክፍያ በኋላ ምዝገባን ቢክድ, ክፍያው ይመለሳል.

የፈቃድ መጠን: domains:register (በዶሜን የተሰጠ:*)

የጥያቄ አካል መለኪያዎች

መለኪያ	አይነት	ያስፈልጋል	መግለጫ የለም
`domain`	string	አዎ	የዶሜይን ስም ሙሉው የ extensionን ጨምሮ፣ ለምሳሌ example.com
`years`	integer	አዎ	የመዝገብ ጊዜ፣ 1 እስከ 10 (የተቀመጠው 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	No payment method on file, or unpaid invoices
500	የክፍያ ሂደት ሊከናወን አልቻለም, ወይም ሪጅስትራሩ ከክፍያ በኋላ ምዝገባን ተቀበለ. በሁለተኛው ሁኔታ ስህተት መልእክት ተመላሽ መውጣት ወይም አለመሄዱን ይናገራል.

ደብዳቤ /api/v1/domains/{uuid}/renew/

ዶሜይንን ያሻሽላል እና ለየዓመቱ የ renovate_priceን ወደ የተጠበቀው የክፍያ ዘዴዎ ያስከፍላል

የፈቃድ መጠን: 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/

ሰርቨሮች

የዶሜይን ስም ሰርቨሮችን በሪጅስትራሩ ላይ ያስተካክላል እና የተሻሻለውን የዶሜይን ንጥል ይመልሳል. የዲ ኤን ኤን ፒ አይፒን ለመቆጣጠር ns1.vps.org, ns2.vps.org እና ns3.vps.org ይጠቀሙ እና ለዶሜይን ክልል ይፈጥሩ

የፈቃድ መጠን: 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	nameserver1 missing
404	አልተገኘም ወይም ሌላ የግልጽነት መለያ ይዟል
500	ማሻሻያ አልተሳካም፤ የፊቱ ክፍል ስህተትና የመልእክት መስኮቶች አለው

PUT /api/v1/domains/{uuid}/auto-renew/

በራሱ መቀጠል

auto_renewን ይጫን እና የተሻሻለውን ዶሜይን አካል ይመልሳል. እንደ JSON ቦሊየን ተደራሽ አድርጎ መላክ: ማንኛውም ያልባከነ መስመር፣ መስመርን ጨምሮ false, auto-renewን ይጫን

የፈቃድ መጠን: 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	Setting saved; the body is the domain object
400	ያልተገኘ
404	አልተገኘም ወይም ሌላ የግልጽነት መለያ ይዟል

ማስታወሻ

የAPIው ዶሜይንን ማጥፋት፣ ዶሜይንን ማስተላለፍ፣ ወይም የ WHOIS የግል መረጃን ወይም የመለወጫ መክፈቻን ማሻሻል አይችልም። ማስተላለፎችና ማጥፋቶች በኮንትራክሽን ፓነል ላይ admin.vps.org ላይ ይገኛሉ።
የዲ ኤን ኤስ መዝገቦች ለዶሜይን በዲ ኤን ኤስ API ይስተዳደራሉ የዲኤንኤስ አስተዳደር ኤፒአይ

VPS.org API

ዶሜን

ሁሉንም ጎራዎች ዘርዝር

የምሳሌ ጥያቄ

የምሳሌ ምላሽ

የምላሽ መስኮች

የዶሜይን ዝርዝሮች

የምላሽ ሁኔታ ኮዶች

የዶሜይን ፈልግ

የጥያቄ አካል መለኪያዎች

የምሳሌ ጥያቄ

የምሳሌ ምላሽ

የምላሽ ሁኔታ ኮዶች

አዲስ ዶሜይን ይመዝገቡ

የጥያቄ አካል መለኪያዎች

የምሳሌ ምላሽ

የምላሽ ሁኔታ ኮዶች

ዶሜን

የጥያቄ አካል መለኪያዎች

የምላሽ ሁኔታ ኮዶች

ሰርቨሮች

የጥያቄ አካል መለኪያዎች

የምላሽ ሁኔታ ኮዶች

በራሱ መቀጠል

የምላሽ ሁኔታ ኮዶች

ማስታወሻ