Домени 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/

Домен за трансфер

Започнете прехвърляне на домейн към 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 година)	Обновяване	Прехвърляне
.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

Списък на всички домейни

Параметри на заявката

Примерна заявка

Примерен отговор

Кодове за състояние на отговора

Регистрирайте нов домейн

Заявка за параметри на тялото

Примерна заявка

Примерен отговор

Кодове за състояние на отговора

Установяване на подробности за домен

Параметри на пътя

Примерна заявка

Примерен отговор

Кодове за състояние на отговора

Обновяване на настройките на домена

Параметри на пътя

Заявка за параметри на тялото

Примерна заявка

Примерен отговор

Кодове за състояние на отговора

Изтриване на домен

Параметри на пътя

Примерна заявка

Кодове за състояние на отговора

Домен за трансфер

Параметри на пътя

Заявка за параметри на тялото

Примерна заявка

Примерен отговор

Кодове за състояние на отговора

Цена на домейн

Популярни ТЛД

Включени функции

Най-добрите практики за управление на домен

Безопасност

Настройване

Трансфери