ዶሜን

አግኝ /api/v1/domains/

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

የዶሜይን ስም

የጥያቄ መለኪያዎች

መለኪያ	አይነት	ያስፈልጋል	መግለጫ የለም
`status`	string	አዎ	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	አዎ	ጎራዎችን በስም ይፈልጉ

የምሳሌ ጥያቄ

cURL

Python

JavaScript

curl -X GET "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const domains = await response.json();
console.log(domains);

የምሳሌ ምላሽ

{
  "count": 3,
  "results": [
    {
      "id": 101,
      "domain_name": "example.com",
      "status": "active",
      "registration_date": "2023-01-15T10:30:00Z",
      "expiration_date": "2026-01-15T10:30:00Z",
      "auto_renew": true,
      "locked": true,
      "nameservers": [
        "ns1.vps.org",
        "ns2.vps.org"
      ],
      "privacy_protection": true,
      "dns_managed_by": "vps.org"
    },
    {
      "id": 102,
      "domain_name": "myapp.io",
      "status": "active",
      "registration_date": "2024-06-20T14:15:00Z",
      "expiration_date": "2025-06-20T14:15:00Z",
      "auto_renew": false,
      "locked": false,
      "nameservers": [
        "ns1.cloudflare.com",
        "ns2.cloudflare.com"
      ],
      "privacy_protection": false,
      "dns_managed_by": "external"
    }
  ]
}

የምላሽ ሁኔታ ኮዶች

200	የጎራዎች ዝርዝር በተሳካ ሁኔታ ተመልሷል
401	ያልተፈቀደ - ልክ ያልሆነ ወይም የጎደለ የማረጋገጫ ቶከን

ደብዳቤ /api/v1/domains/

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

አዲስ ዶሜይን ስም መዝገብ. ዶሜይን መኖሩን ከመመዝገብዎ በፊት ማረጋገጥ አለብዎት.

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

መለኪያ	አይነት	ያስፈልጋል	መግለጫ የለም
`domain_name`	string	አዎ	Domain name to register (e.g., "example.com")
`years`	integer	አዎ	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	አዎ	Enable automatic renewal (default: true)
`privacy_protection`	boolean	አዎ	Enable WHOIS privacy protection (default: true)
`nameservers`	array	አዎ	Custom nameservers (default: VPS.org nameservers)

የምሳሌ ጥያቄ

cURL

Python

JavaScript

PHP

curl -X POST "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_name": "mynewdomain.com",
    "years": 2,
    "auto_renew": true,
    "privacy_protection": true
  }'

import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "domain_name": "mynewdomain.com",
    "years": 2,
    "auto_renew": True,
    "privacy_protection": True
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    domain_name: 'mynewdomain.com',
    years: 2,
    auto_renew: true,
    privacy_protection: true
  })
});

const domain = await response.json();
console.log(domain);

$data = [
    'domain_name' => 'mynewdomain.com',
    'years' => 2,
    'auto_renew' => true,
    'privacy_protection' => true
];

$ch = curl_init('https://admin.vps.org/api/v1/domains/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$domain = json_decode($response, true);
curl_close($ch);

የምሳሌ ምላሽ

{
  "id": 103,
  "domain_name": "mynewdomain.com",
  "status": "pending",
  "registration_date": "2026-01-16T16:00:00Z",
  "expiration_date": "2028-01-16T16:00:00Z",
  "auto_renew": true,
  "locked": true,
  "nameservers": [
    "ns1.vps.org",
    "ns2.vps.org"
  ],
  "privacy_protection": true,
  "dns_managed_by": "vps.org",
  "total_cost": 24.98,
  "message": "Domain registration initiated. Processing may take 5-10 minutes."
}

የምላሽ ሁኔታ ኮዶች

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	ያልተፈቀደ - ልክ ያልሆነ ወይም የጎደለ የማረጋገጫ ቶከን
402	Payment Required - Insufficient account balance

ማስታወሻ፦ Domain registration is not instant. Status will change from pending to active within 5-10 minutes. You'll receive an email confirmation when registration completes.

አግኝ /api/v1/domains/{domain_id}/

የዶሜይን ዝርዝሮች

ስለተወሰነ ዶሜይን ዝርዝር መረጃ ማግኘት

የመንገድ መለኪያዎች

መለኪያ	አይነት	ያስፈልጋል	መግለጫ የለም
`domain_id`	integer	አዎ	Unique domain ID

የምሳሌ ጥያቄ

cURL

Python

JavaScript

curl -X GET "https://admin.vps.org/api/v1/domains/101/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const domain = await response.json();
console.log(domain);

የምሳሌ ምላሽ

{
  "id": 101,
  "domain_name": "example.com",
  "status": "active",
  "registration_date": "2023-01-15T10:30:00Z",
  "expiration_date": "2026-01-15T10:30:00Z",
  "auto_renew": true,
  "locked": true,
  "nameservers": [
    "ns1.vps.org",
    "ns2.vps.org"
  ],
  "privacy_protection": true,
  "dns_managed_by": "vps.org",
  "registrar": "VPS.org",
  "days_until_expiration": 730,
  "whois_info": {
    "registrant": "Privacy Protected",
    "admin_contact": "Privacy Protected",
    "tech_contact": "Privacy Protected",
    "created_date": "2023-01-15",
    "updated_date": "2025-12-20"
  },
  "dns_records_count": 12
}

የምላሽ ሁኔታ ኮዶች

200	Successfully retrieved domain details
401	ያልተፈቀደ - ልክ ያልሆነ ወይም የጎደለ የማረጋገጫ ቶከን
404	አልተገኘም - ጎራ የለም

ፑት /api/v1/domains/{domain_id}/

የዶሜይን ምርጫዎች

የዶሜይን ማስተካከያ እንደ አውቶማቲክ-ማሻሻያ፣ ስም ሰርቨሮች፣ እና የግል ምርጫዎች ያሻሽሉ

የመንገድ መለኪያዎች

መለኪያ	አይነት	ያስፈልጋል	መግለጫ የለም
`domain_id`	integer	አዎ	Unique domain ID

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

መለኪያ	አይነት	ያስፈልጋል	መግለጫ የለም
`auto_renew`	boolean	አዎ	Enable or disable automatic renewal
`privacy_protection`	boolean	አዎ	Enable or disable WHOIS privacy
`nameservers`	array	አዎ	Update nameservers (2-4 nameservers required)
`locked`	boolean	አዎ	Lock or unlock domain to prevent transfers

የምሳሌ ጥያቄ

cURL

Python

JavaScript

curl -X PUT "https://admin.vps.org/api/v1/domains/101/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "auto_renew": false,
    "nameservers": [
      "ns1.cloudflare.com",
      "ns2.cloudflare.com"
    ]
  }'

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "auto_renew": False,
    "nameservers": [
        "ns1.cloudflare.com",
        "ns2.cloudflare.com"
    ]
}

response = requests.put(url, headers=headers, json=data)
print(response.json())

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/`, {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    auto_renew: false,
    nameservers: [
      'ns1.cloudflare.com',
      'ns2.cloudflare.com'
    ]
  })
});

const domain = await response.json();
console.log(domain);

የምሳሌ ምላሽ

{
  "id": 101,
  "domain_name": "example.com",
  "status": "active",
  "auto_renew": false,
  "nameservers": [
    "ns1.cloudflare.com",
    "ns2.cloudflare.com"
  ],
  "privacy_protection": true,
  "locked": true,
  "message": "Domain settings updated successfully. Nameserver changes may take up to 24 hours to propagate."
}

የምላሽ ሁኔታ ኮዶች

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	ያልተፈቀደ - ልክ ያልሆነ ወይም የጎደለ የማረጋገጫ ቶከን
404	አልተገኘም - ጎራ የለም

ሰርዝ /api/v1/domains/{domain_id}/

ዶሜይን አጥፉ

ዶሜይንን ከሂሳብዎ አጥፉ ይህ የዶሜይንን ምዝገባ አያቋርጥም - ከVPS.org ሂሳብ አስተዳደርዎ ብቻ ያስወግዳል

የመንገድ መለኪያዎች

መለኪያ	አይነት	ያስፈልጋል	መግለጫ የለም
`domain_id`	integer	አዎ	Unique domain ID

የምሳሌ ጥያቄ

cURL

Python

JavaScript

curl -X DELETE "https://admin.vps.org/api/v1/domains/101/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.delete(url, headers=headers)
print(response.status_code)

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

console.log(response.status);

የምላሽ ሁኔታ ኮዶች

204	Domain removed from account successfully
401	ያልተፈቀደ - ልክ ያልሆነ ወይም የጎደለ የማረጋገጫ ቶከን
404	አልተገኘም - ጎራ የለም

Important: Deleting a domain from your VPS.org account does NOT cancel the registration. The domain will continue to be registered and will auto-renew if enabled. To cancel a domain registration, disable auto-renewal and let it expire.

ደብዳቤ /api/v1/domains/{domain_id}/transfer/

ዶሜይን

ከሌላ ሪጅስትራተር ወደ VPS.org ዶሜይን ማስተላለፍን ይጀምሩ

የመንገድ መለኪያዎች

መለኪያ	አይነት	ያስፈልጋል	መግለጫ የለም
`domain_id`	integer	አዎ	Unique domain ID

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

መለኪያ	አይነት	ያስፈልጋል	መግለጫ የለም
`auth_code`	string	አዎ	EPP/Authorization code from current registrar
`auto_renew`	boolean	አዎ	Enable auto-renewal after transfer (default: true)

የምሳሌ ጥያቄ

cURL

Python

JavaScript

curl -X POST "https://admin.vps.org/api/v1/domains/101/transfer/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_code": "Xy9Kl2Mn#4pQ",
    "auto_renew": true
  }'

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/transfer/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "auth_code": "Xy9Kl2Mn#4pQ",
    "auto_renew": True
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/transfer/`, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    auth_code: 'Xy9Kl2Mn#4pQ',
    auto_renew: true
  })
});

const transfer = await response.json();
console.log(transfer);

የምሳሌ ምላሽ

{
  "id": 101,
  "domain_name": "example.com",
  "transfer_status": "pending",
  "transfer_initiated_at": "2026-01-16T16:30:00Z",
  "estimated_completion": "2026-01-23T16:30:00Z",
  "message": "Domain transfer initiated. You should receive a confirmation email from your current registrar. Transfer typically completes within 5-7 days.",
  "next_steps": [
    "Check email for transfer authorization request",
    "Approve transfer with current registrar",
    "Wait for transfer to complete (5-7 days)",
    "Domain will be automatically renewed for 1 year upon completion"
  ]
}

የምላሽ ሁኔታ ኮዶች

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	ያልተፈቀደ - ልክ ያልሆነ ወይም የጎደለ የማረጋገጫ ቶከን
404	አልተገኘም - ጎራ የለም
402	Payment Required - Insufficient account balance for transfer fee

የቀን መቁጠሪያ አሳሽ

ዶሜይን በ presented register ውስጥ መክፈት አለበት
ዶሜይን በትንሹ 60 ቀናት መሆን አለበት
የዋለ EPP/Auth ኮድ ያስፈልጋል
WHOIS ኢሜይል ለምርጫው ሊደርስበት ይገባል
1 ዓመት የቀጠሮ ጊዜ (የክፍያ ክፍያ)

ዶሜይን

የተለመዱ

ከፍ ያለ ደረጃ	ምዝገባ (1 ዓመት)	አዲስ	ላኪ
.com	$12.99	$12.99	$12.99
.net	$14.99	$14.99	$14.99
.org	$13.99	$13.99	$13.99
.io	$39.99	$39.99	$39.99
.dev	$14.99	$14.99	$14.99
.app	$14.99	$14.99	$14.99
.co	$24.99	$24.99	$24.99

የተካተቱ ባህሪያት

✓ ነጻ የ WHOIS የግል መረጃ
✓ የዲ ኤን ኤ አስተዳደር
✓ ኢሜይል አድራሻ
✓ ነጻ ዶሜይን ማስተላለፍ

✓ ነጻ ዶሜይን መክፈት
✓ 24/7 ድጋፍ
✓ የዶሜይን አስተዳደር
✓ የራስ-አሻሽል ምርጫ

የዶሜይን አስተዳደር

ደህንነት

የዶሜይን መክፈቻን አስጀምር: ያልተፈቀደ ማስተላለፍን ይከላከላል
የግል መረጃን መጠበቅ አስጀምር፦ የግል መረጃዎን ከ WHOIS ይደብቃል
ሚስጢራዊ ቃላትን ይጠቀሙ የVPS.org ሒሳብዎን ይጠብቁ
2FAን አስጀምር፦ የግል መለያዎ
ቀን፦ የቀን መቁጠሪያ ማስታወሻዎች

የፊደል ቅርጽ ምርጫዎች

የDNS ማስተካከያ ሰርቨሮችን ወደ VPS.org ለማስቀመጥ ሞክሩ
በራሱ የዶሜይን ጊዜን ለማስቆም ያስችሉ
ግንኙነት የWHOIS ግንኙነት መረጃን በቅርብ ጊዜ ያሳድጉ
የDNS バックアップ: የድምጽ ፋይል

መተላለፊያ

60-ቀን መክፈቻ: ዶሜንዎች ከመዝገብ ወይም ከቀድሞው ማስተላለፍ 60 ቀናት ውስጥ ሊተላለፉ አይችሉም
ዶሜይን የቀድሞው መዝገብ ቤት
የፍለጋ ኮድ፦ የEPP/የመረጋገጫ ኮድ ከአሁኑ መዝገብ ቤት ይጠይቁ
ኢሜይል በሂደቱ ወቅት የምርጫ ኢሜይልን ማግኘት ትችላላችሁ
ወደፊት መላኪያ 5-7 ቀናት ሊወስድ ይችላል

VPS.org API

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

የጥያቄ መለኪያዎች

የምሳሌ ጥያቄ

የምሳሌ ምላሽ

የምላሽ ሁኔታ ኮዶች

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

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

የምሳሌ ጥያቄ

የምሳሌ ምላሽ

የምላሽ ሁኔታ ኮዶች

የዶሜይን ዝርዝሮች

የመንገድ መለኪያዎች

የምሳሌ ጥያቄ

የምሳሌ ምላሽ

የምላሽ ሁኔታ ኮዶች

የዶሜይን ምርጫዎች

የመንገድ መለኪያዎች

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

የምሳሌ ጥያቄ

የምሳሌ ምላሽ

የምላሽ ሁኔታ ኮዶች

ዶሜይን አጥፉ

የመንገድ መለኪያዎች

የምሳሌ ጥያቄ

የምላሽ ሁኔታ ኮዶች

ዶሜይን

የመንገድ መለኪያዎች

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

የምሳሌ ጥያቄ

የምሳሌ ምላሽ

የምላሽ ሁኔታ ኮዶች

ዶሜይን

የተለመዱ

የተካተቱ ባህሪያት

የዶሜይን አስተዳደር

ደህንነት

የፊደል ቅርጽ ምርጫዎች

መተላለፊያ