Domény API

ZÍSKAT /api/v1/domains/

Zobrazit všechny domény

Získejte seznam všech domén registrovaných na vašem účtu.

Parametry dotazu

Parametr	Typ	Požadovaný	Popis zboží
`status`	string	Ne.	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Ne.	Vyhledávání domén podle názvu

Příklad žádosti

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);

Příklad odpovědi

{
  "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"
    }
  ]
}

Kódy stavu odpovědi

200	Seznam domén byl úspěšně načten
401	Neoprávněné – Neplatný nebo chybějící ověřovací token

POST /api/v1/domains/

Registrace nové domény

Zaregistrujte nové doménové jméno. Dostupnost domény je třeba zkontrolovat před registrací.

Parametry těla požadavku

Parametr	Typ	Požadovaný	Popis zboží
`domain_name`	string	Ano	Domain name to register (e.g., "example.com")
`years`	integer	Ne.	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	Ne.	Enable automatic renewal (default: true)
`privacy_protection`	boolean	Ne.	Enable WHOIS privacy protection (default: true)
`nameservers`	array	Ne.	Custom nameservers (default: VPS.org nameservers)

Příklad žádosti

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);

Příklad odpovědi

{
  "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."
}

Kódy stavu odpovědi

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Neoprávněné – Neplatný nebo chybějící ověřovací token
402	Payment Required - Insufficient account balance

Poznámka: 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.

ZÍSKAT /api/v1/domains/{domain_id}/

Získat detaily domény

Získejte podrobné informace o konkrétní doméně.

Parametry cesty

Parametr	Typ	Požadovaný	Popis zboží
`domain_id`	integer	Ano	Unique domain ID

Příklad žádosti

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);

Příklad odpovědi

{
  "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
}

Kódy stavu odpovědi

200	Successfully retrieved domain details
401	Neoprávněné – Neplatný nebo chybějící ověřovací token
404	Nenalezeno - Doména neexistuje

DÁT /api/v1/domains/{domain_id}/

Aktualizovat nastavení domény

Aktualizovat konfiguraci domény, jako je automatické obnovování, nameservery a nastavení soukromí.

Parametry cesty

Parametr	Typ	Požadovaný	Popis zboží
`domain_id`	integer	Ano	Unique domain ID

Parametry těla požadavku

Parametr	Typ	Požadovaný	Popis zboží
`auto_renew`	boolean	Ne.	Enable or disable automatic renewal
`privacy_protection`	boolean	Ne.	Enable or disable WHOIS privacy
`nameservers`	array	Ne.	Update nameservers (2-4 nameservers required)
`locked`	boolean	Ne.	Lock or unlock domain to prevent transfers

Příklad žádosti

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);

Příklad odpovědi

{
  "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."
}

Kódy stavu odpovědi

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Neoprávněné – Neplatný nebo chybějící ověřovací token
404	Nenalezeno - Doména neexistuje

VYMAZAT /api/v1/domains/{domain_id}/

Smazat doménu

Smazání domény z vašeho účtu. To nezruší registraci domény - pouze ji odstraní z vašeho řízení účtu VPS.org.

Parametry cesty

Parametr	Typ	Požadovaný	Popis zboží
`domain_id`	integer	Ano	Unique domain ID

Příklad žádosti

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);

Kódy stavu odpovědi

204	Domain removed from account successfully
401	Neoprávněné – Neplatný nebo chybějící ověřovací token
404	Nenalezeno - Doména neexistuje

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.

POST /api/v1/domains/{domain_id}/transfer/

Přenosová doména

Zahájit přenos domény na VPS.org z jiného registrátora.

Parametry cesty

Parametr	Typ	Požadovaný	Popis zboží
`domain_id`	integer	Ano	Unique domain ID

Parametry těla požadavku

Parametr	Typ	Požadovaný	Popis zboží
`auth_code`	string	Ano	EPP/Authorization code from current registrar
`auto_renew`	boolean	Ne.	Enable auto-renewal after transfer (default: true)

Příklad žádosti

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);

Příklad odpovědi

{
  "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"
  ]
}

Kódy stavu odpovědi

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Neoprávněné – Neplatný nebo chybějící ověřovací token
404	Nenalezeno - Doména neexistuje
402	Payment Required - Insufficient account balance for transfer fee

Požadavky na přenos:

Doména musí být odemčena u současného registrátora
Doména musí být nejméně 60 dní stará.
Požadovaný platný kód EPP/Auth
E-mail WHOIS musí být přístupný ke schválení
Převod zahrnuje jednoleté prodloužení (poplatek se použije)

Ceny domén

Populární TLD

TLD	Registrace (1 rok)	Obnovení	Převod
.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

Zahrnuté funkce

✓ Bezplatná ochrana soukromí WHOIS
✓ Volný DNS management
✓ Posílání e-mailů zdarma
✓ Free Domain Forwarding

✓ Volný uzamčení domény
✓ Podpora 24/7
✓ Snadná správa domén
✓ Možnost automatického obnovení

Nejlepší postupy doménového řízení

Bezpečnost

Povolit zamykání domény: Zabrání neoprávněným převodům
Povolit ochranu soukromí: Skrývá vaše osobní údaje od WHOIS
Použít silná hesla: Chraňte svůj účet VPS.org
Povolit 2FA: Přidat dodatečnou jistotu na váš účet
Sledovat data spotřeby: Nastavit automatické obnovení nebo připomínky kalendáře

Nastavení

Nastavení DNS: Point nameservers to VPS.org for easy management
Automatické obnovení: Povolit zabránit náhodnému ukončení domény
Kontaktní informace: Udržovat informace o kontaktech WHOIS aktuální
Zálohování DNS: Vezměme si sekundární DNS poskytovatele pro redundance

Převody

60-denní zámek: Domény nelze převést do 60 dnů od registrace nebo předchozího převodu
Odemknout doménu: Musí být odemknuto na aktuální registrátor před převodem
Získat Auth kód: Požádat EPP/autorizační kód od současného registrátora
Zkontrolovat email: Během procesu přenosu obdržíte schvalovací e-maily
Plán Ahead: Převody mohou trvat 5-7 dní dokončit

VPS.org API

Zobrazit všechny domény

Parametry dotazu

Příklad žádosti

Příklad odpovědi

Kódy stavu odpovědi

Registrace nové domény

Parametry těla požadavku

Příklad žádosti

Příklad odpovědi

Kódy stavu odpovědi

Získat detaily domény

Parametry cesty

Příklad žádosti

Příklad odpovědi

Kódy stavu odpovědi

Aktualizovat nastavení domény

Parametry cesty

Parametry těla požadavku

Příklad žádosti

Příklad odpovědi

Kódy stavu odpovědi

Smazat doménu

Parametry cesty

Příklad žádosti

Kódy stavu odpovědi

Přenosová doména

Parametry cesty

Parametry těla požadavku

Příklad žádosti

Příklad odpovědi

Kódy stavu odpovědi

Ceny domén

Populární TLD

Zahrnuté funkce

Nejlepší postupy doménového řízení

Bezpečnost

Nastavení

Převody