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}/

Абнавіць настаўленні дамену

Абнавіць настаўленні дамена, такія як аўтаабнаўленне, серверы імёнаў і настаўленні прыватнасці.

Параметры шляху

Параметры	Тып	Абавязкова	Апісанне
`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/

Перанесці дамен

Initiate a domain transfer to VPS.org from another registrar.

Параметры шляху

Параметры	Тып	Абавязкова	Апісанне
`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 павінна быць даступная для зацвярджэння
Перадача ўключае аднагадовую рэгістрацыю (плацежаздольнасць)

Працэнтная стаўка

Папулярныя TLD

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
✓ Перасылаць электронную пошту
✓ Перасылаць дамен

✓ Блакаванне свабодных даменаў
✓ Падтрымка
✓ Простае кіраванне даменаміName
✓ Аўтаматычнае абнаўленне

Кіраванне даменамі

Бяспека

Уключыць блакаванне даменаў: Захоўвае ад несанкцыянаваных пераданняў
Уключыць абарону прыватнасці: Схаваць вашыя асабістыя зьвесткі ад WHOIS
Выкарыстоўваць моцныя паролі: Абараніць ваш рахунак VPS.org
Уключыць 2FA: Дадаць дадатковую абарону да вашага рахунку
Дата заканчэння тэрміну дзеяння: Настаўленні напамінкаў аб аўтаматычным абнаўленні або календара

Настаўленні

Настаўленні DNS: Накіраваць серверы імёнаў на VPS.org для лёгкага кіравання
Аўтаматычнае абнаўленне: Уключыць для прадухілення выпадковага заканчэння тэрміну дзеяння дамену
Звесткі пра кантакт: Абнаўляць звесткі пра кантакт WHOIS
Рэзервовая копія DNS: Улічваць дадатковы пастаўшчык DNS для бяспекі

Перадачы

60- дзённы блакаванне: Дамен не можа быць перанесены ў перыяд 60 дзён з моманту рэгістрацыі або папярэдняга пераносу
Разблакаваць дамен: Перад перадачай трэба разблакаваць у бягучым рэгістратары
Атрымаць аўтарызацыйны код: Запытаць EPP/аўтарызацыйны код ад бягучага рэгістратара
Праверыць электронную пошту: Вы атрымаеце лісты пацверджання падчас працэсу перадачы
Планаваць наперад: Перадачы могуць заняць 5- 7 дзён

VPS.org API

API даменаў

Спіс усіх даменаў

Параметры запыту

Прыклад запыту

Прыклад адказу

Коды стану адказу

Рэгістрацыя новага дамена

Запытаць параметры цела

Прыклад запыту

Прыклад адказу

Коды стану адказу

Атрымаць падрабязнасці дамена

Параметры шляху

Прыклад запыту

Прыклад адказу

Коды стану адказу

Абнавіць настаўленні дамену

Параметры шляху

Запытаць параметры цела

Прыклад запыту

Прыклад адказу

Коды стану адказу

Выдаліць дамен

Параметры шляху

Прыклад запыту

Коды стану адказу

Перанесці дамен

Параметры шляху

Запытаць параметры цела

Прыклад запыту

Прыклад адказу

Коды стану адказу

Працэнтная стаўка

Папулярныя TLD

Уключаныя функцыі

Кіраванне даменамі

Бяспека

Настаўленні

Перадачы