ඩොමේන API

ලබා ගන්න /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}/

ඩොමේන් සැකසුම් යාවත්කාලීන කරන්න

එවැනි ස්වයංක්රීය-නවත්වීමේ, nameservers, සහ පෞද්ගලිකත්ව සැකසුම් ලෙස ඩොමේන් වින්ඩ්සර්වර් යාවත්කාලීන.

මාර්ග පරාමිතීන්

පරාමිතීන්	වර්ගය	අවශ්‍යයි	විස්තරය
`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

මාරු අවශ්යතා:

වත්මන් ලියාපදිංචිකරු විසින් ඩොමේනය අගුළු දැමිය යුතුයි
ඩොමේන් අවම වශයෙන් 60 දින වයස විය යුතුය
වලංගු EPP/Auth කේතය අවශ්ය වේ
WHOIS විද්යුත් තැපෑල අනුමැතිය සඳහා ප්රවේශ විය යුතුය
මාරු කිරීම 1-අවුරුදු අලුත් කිරීම ඇතුළත් වේ (ගාස්තු අය කෙරේ)

ඩොමේන් මිලදී ගැනීම

ජනප්රිය TLDs

TLD	ලියාපදිංචිය (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 පෞද්ගලිකත්ව ආරක්ෂාව
✓ නිදහස් DNS කළමනාකරණය
✓ නිදහස් විද්යුත් තැපැල් ඉදිරියට
✓ නිදහස් ඩොමේන් ඉදිරියට

✓ නිදහස් ඩොමේන් අගුළු
✓ 24/7 සහාය
✓ පහසු ඩොමේන් කළමනාකරණය
✓ ස්වයංක්රීය අලුත් කිරීම විකල්පය

ඩොමේන් කළමනාකරණ හොඳම ප්රතිපත්ති

ආරක්ෂාව

ඩොමේන් අගුළුලීම සක්‍රීය කරන්න: බලපත්‍ර රහිත මාරු වැළැක්වීම
පෞද්ගලිකත්ව ආරක්ෂණය සක්‍රීය කරන්න: WHOIS සිට ඔබේ පෞද්ගලික තොරතුරු සැඟවෙනවා
ශක්තිමත් මුරපද භාවිත කරන්න: ඔබේ VPS.org ගිණුම ආරක්ෂා කරන්න
2FA සක්‍රීය කරන්න: ඔබේ ගිණුමට අමතර ආරක්ෂාව එක් කරන්න
කල් ඉකුත්වීමේ දිනය නිරීක්‍ෂණය කරන්න: ස්වයංක්‍රීය-නැවතුම් හෝ දිනදර්ශන සිහිපත් සකසන්න

සැකසුම්

DNS සකසන්න: පහසු කළමනාකරණය සඳහා VPS.org වෙත නාම සේවාදායක පෙන්වන්න
ස්වයංක්‍රීයව අලුත් කරන්න: වසම් කල් ඉකුත්වීම වැළැක්වීම සඳහා සක්‍රීය කරන්න
සම්බන්ධතා තොරතුරු: WHOIS සම්බන්ධතා තොරතුරු යාවත්කාලීන තබා ගන්න
පිටපත් DNS: අවශ්යතාවය සඳහා ද්විතීයික DNS සැපයුම්කරු සලකා බලන්න

මාරු කිරීම්

දින 60 අගුළු: ඩොමේන් ලියාපදිංචි හෝ පෙර මාරු දින 60 තුළ මාරු කළ නොහැකි
ඩොමේනය අගුළු ලන්න: මාරු කිරීමට පෙර වත්මන් ලියාපදිංචිකරු විසින් අගුළු දැමිය යුතු ය
බලපත්‍ර කේතය ලබාගන්න: වත්මන් ලියාපදිංචිකරුගෙන් EPP / බලපත්ර කේතය ඉල්ලා
විද්‍යුත් තැපෑල පරීක්ෂා කරන්න: ඔබ මාරු ක්රියාවලිය තුළ අනුමැතිය ඊ-තැපැල් ලැබෙනු ඇත
සැලසුම් ඉදිරියට: මාරු කිරීම් සම්පූර්ණ කිරීමට දින 5-7 ගත හැක

VPS.org API

ඩොමේන API

සියලුම වසම් ලැයිස්තුගත කරන්න

විමසුම් පරාමිතීන්

උදාහරණ ඉල්ලීම

උදාහරණ ප්‍රතිචාරය

ප්‍රතිචාර තත්ව කේත

නව වසමක් ලියාපදිංචි කරන්න

ඉල්ලීම් ශරීර පරාමිතීන්

උදාහරණ ඉල්ලීම

උදාහරණ ප්‍රතිචාරය

ප්‍රතිචාර තත්ව කේත

ඩොමේන් විස්තර ලබාගන්න

මාර්ග පරාමිතීන්

උදාහරණ ඉල්ලීම

උදාහරණ ප්‍රතිචාරය

ප්‍රතිචාර තත්ව කේත

ඩොමේන් සැකසුම් යාවත්කාලීන කරන්න

මාර්ග පරාමිතීන්

ඉල්ලීම් ශරීර පරාමිතීන්

උදාහරණ ඉල්ලීම

උදාහරණ ප්‍රතිචාරය

ප්‍රතිචාර තත්ව කේත

ඩොමේනය මකන්න

මාර්ග පරාමිතීන්

උදාහරණ ඉල්ලීම

ප්‍රතිචාර තත්ව කේත

ඩොමේනය මාරු කරන්න

මාර්ග පරාමිතීන්

ඉල්ලීම් ශරීර පරාමිතීන්

උදාහරණ ඉල්ලීම

උදාහරණ ප්‍රතිචාරය

ප්‍රතිචාර තත්ව කේත

ඩොමේන් මිලදී ගැනීම

ජනප්රිය TLDs

ඇතුළත් විශේෂාංග

ඩොමේන් කළමනාකරණ හොඳම ප්රතිපත්ති

ආරක්ෂාව

සැකසුම්

මාරු කිරීම්