Домендер 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 жылдық жаңарту кіреді (ақы төленеді)

Домен бағасы

Тапшылығы бар 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

Қосылған мүмкіндіктер

✓ Құпия сөзді қорғау
✓ DNS-ті басқаруName
✓ Бос эл. поштаны қайта жолдау
✓ Бос домендерді қайта бағыттау

✓ Бос домендерді бұғаттауы
✓ 24/7 қолдау
✓ Домендерді басқаруName
✓ Автожаңарту параметрі

Доменді басқарудың ең жақсы тәсілдері

Қауіпсіздік

Доменді бұғаттау рұқсат етілсін: Рұқсатсыз тасымалдауды болдырмау
Дербестікті қорғауды рұқсат ету: WHOIS- тан дербес мәліметтеріңізді жасыру
Қауіпсіз парольдер қолданылсын: VPS.org тіркелгіңізді қорғау
2FA рұқсат етілсін: Тіркелгіңізге қосымша қауіпсіздікті қосу
Сақталған мерзімі: Күнтізбелік ескертулерді автоматты түрде жаңартуды баптау

Баптау

DNS баптаулары: Әрекет ету оңай болу үшін атау серверлерін VPS.org- ге бағыттау
Автожаңарту: Доменнің мерзімі бітуін болдырмау үшін рұқсат етілсін
Контакт мәліметі: WHOIS контакт мәліметі жаңартылсын
Сақтық көшірме DNS: Екінші DNS провайдерін қосалқы ретінде қарастыру

Аударулар

60 күндік бұғаттау: Домендерді тіркеу немесе бұрынғы ауысуынан кейін 60 күн ішінде ауыстыруға болмайды
Доменнің бұғатын шешу: Ауыстырғаннан бұрын назардағы регистрде бұғатты шешу керек
Аутентификация кодын алу: Назардағы регистратордан EPP/аутентификация кодын сұрау
Эл. поштаны тексеру: Аудару кезінде растау эл. поштасын аласыз
Жоспарлау: Аудару 5- 7 күнге созылады

VPS.org API

Домендер API

Барлық домендерді тізімдеу

Сұрау параметрлері

Мысал сұрау

Мысал жауап

Жауап күйінің кодтары

Жаңа доменді тіркеу

Сұрау мәтінінің параметрлері

Мысал сұрау

Мысал жауап

Жауап күйінің кодтары

Доменнің егжей- тегжейін алу

Жол параметрлері

Мысал сұрау

Мысал жауап

Жауап күйінің кодтары

Домен параметрлерін жаңарту

Жол параметрлері

Сұрау мәтінінің параметрлері

Мысал сұрау

Мысал жауап

Жауап күйінің кодтары

Доменді өшіру

Жол параметрлері

Мысал сұрау

Жауап күйінің кодтары

Доменді ауыстыру

Жол параметрлері

Сұрау мәтінінің параметрлері

Мысал сұрау

Мысал жауап

Жауап күйінің кодтары

Домен бағасы

Тапшылығы бар TLD- лер

Қосылған мүмкіндіктер

Доменді басқарудың ең жақсы тәсілдері

Қауіпсіздік

Баптау

Аударулар