Домена 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/Out
Электронная почта ВОЗИС должна быть доступна для утверждения
Перевод включает продление на один год (применяется плата)

Домена

ТЛД	Регистрация (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

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

✓ Бесплатная защита частной жизни
✓ Бесплатное управление DNS
✓ Бесплатное пересылание по электронной почте
✓ Свободный домен экспедиции

✓ Свободное замыкание домена
✓ 24/7 Поддержка
✓ Легкое управление достопримечательностями
✓ Опция Автообновления

Передовая практика управления доменами

Безопасность

Включить блокировку домена: Предотвращение несанкционированных передач
Предоставить защиту конфиденциальности: Скрывает вашу личную информацию из WHOIS
Использовать сильные пароли: Защищайте свой VPS.org аккаунт.
Включить 2FA: Добавьте дополнительную охрану к вашему счету
Отслеживание дат истечения срока действия: Напоминание об автовозобновлении или календаре

Конфигурация

Настройка DNS: От серверов до VPS.org для легкого управления
Автообновление: Возможность предотвращения случайного истечения срока действия домена
Контактная информация: Обновление контактной информации WHOIS
Подкрепление DNS: Рассмотреть вопрос о вторичном поставщике DNS для избыточности

Переводы

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

VPS.org API

Домена API

Список всех доменов

Параметры запроса

Пример запроса

Пример ответа

Коды состояния ответа

Зарегистрировать новый домен

Параметры тела запроса

Пример запроса

Пример ответа

Коды состояния ответа

Получить подробности области

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

Пример запроса

Пример ответа

Коды состояния ответа

Обновить параметры области

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

Параметры тела запроса

Пример запроса

Пример ответа

Коды состояния ответа

Удалить домен

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

Пример запроса

Коды состояния ответа

Домена передачи

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

Параметры тела запроса

Пример запроса

Пример ответа

Коды состояния ответа

Домена

Популярные ТВУ

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

Передовая практика управления доменами

Безопасность

Конфигурация

Переводы