API domen

DOSTAWAĆ /api/v1/domains/

Wyświetl wszystkie domeny

Pobierz listę wszystkich domen zarejestrowanych na Twoim koncie.

Parametry zapytania

Parametr	Typ	Wymagany	Opis
`status`	string	Nie.	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Nie.	Wyszukaj domeny według nazwy

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Kody statusu odpowiedzi

200	Pomyślnie pobrano listę domen
401	Nieautoryzowany – nieprawidłowy lub brakujący token uwierzytelniający

POST /api/v1/domains/

Zarejestruj nową domenę

Zarejestruj nową nazwę domeny. Przed rejestracją należy sprawdzić dostępność domeny.

Parametry treści żądania

Parametr	Typ	Wymagany	Opis
`domain_name`	string	Tak	Domain name to register (e.g., "example.com")
`years`	integer	Nie.	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	Nie.	Enable automatic renewal (default: true)
`privacy_protection`	boolean	Nie.	Enable WHOIS privacy protection (default: true)
`nameservers`	array	Nie.	Custom nameservers (default: VPS.org nameservers)

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Kody statusu odpowiedzi

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Nieautoryzowany – nieprawidłowy lub brakujący token uwierzytelniający
402	Payment Required - Insufficient account balance

Uwaga: 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.

DOSTAWAĆ /api/v1/domains/{domain_id}/

Pobierz szczegóły domeny

Pobierz szczegółowe informacje na temat konkretnej domeny.

Parametry ścieżki

Parametr	Typ	Wymagany	Opis
`domain_id`	integer	Tak	Unique domain ID

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Kody statusu odpowiedzi

200	Successfully retrieved domain details
401	Nieautoryzowany – nieprawidłowy lub brakujący token uwierzytelniający
404	Nie znaleziono – Domena nie istnieje

UMIEŚCIĆ /api/v1/domains/{domain_id}/

Uaktualnij ustawienia domeny

Aktualizuj konfigurację domeny, takie jak automatyczne odnawianie, serwery nazw i ustawienia prywatności.

Parametry ścieżki

Parametr	Typ	Wymagany	Opis
`domain_id`	integer	Tak	Unique domain ID

Parametry treści żądania

Parametr	Typ	Wymagany	Opis
`auto_renew`	boolean	Nie.	Enable or disable automatic renewal
`privacy_protection`	boolean	Nie.	Enable or disable WHOIS privacy
`nameservers`	array	Nie.	Update nameservers (2-4 nameservers required)
`locked`	boolean	Nie.	Lock or unlock domain to prevent transfers

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Kody statusu odpowiedzi

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Nieautoryzowany – nieprawidłowy lub brakujący token uwierzytelniający
404	Nie znaleziono – Domena nie istnieje

USUWAĆ /api/v1/domains/{domain_id}/

Usuń domenę

Usuń domenę z konta. To nie anuluje rejestracji domeny - usuwa ją tylko z Twojego VPS.org zarządzania kontami.

Parametry ścieżki

Parametr	Typ	Wymagany	Opis
`domain_id`	integer	Tak	Unique domain ID

Przykładowe żądanie

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

Kody statusu odpowiedzi

204	Domain removed from account successfully
401	Nieautoryzowany – nieprawidłowy lub brakujący token uwierzytelniający
404	Nie znaleziono – Domena nie istnieje

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/

Domena transferu

Rozpocznij transfer domeny na VPS.org z innego rejestratora.

Parametry ścieżki

Parametr	Typ	Wymagany	Opis
`domain_id`	integer	Tak	Unique domain ID

Parametry treści żądania

Parametr	Typ	Wymagany	Opis
`auth_code`	string	Tak	EPP/Authorization code from current registrar
`auto_renew`	boolean	Nie.	Enable auto-renewal after transfer (default: true)

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Kody statusu odpowiedzi

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Nieautoryzowany – nieprawidłowy lub brakujący token uwierzytelniający
404	Nie znaleziono – Domena nie istnieje
402	Payment Required - Insufficient account balance for transfer fee

Wymagania dotyczące transferu:

Domena musi być otwarta w bieżącym rejestrze
Domena musi mieć co najmniej 60 dni
Wymagany ważny kod EPP/Auth
E-mail WHOIS musi być dostępny do zatwierdzenia
Transfer obejmuje odnowienie okresu 1 roku (stosuje się)

Cennik wartości domeny

Popularne TDD

TLD	Rejestracja (1 rok)	Odnowienie	Przeniesienie
.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

Zawarte funkcje

✓ Wolna ochrona prywatności WHOIS
✓ Wolne zarządzanie DNS
✓ Darmowe przesłanie e- maila
✓ Darmowe przesłanie domeny

✓ Darmowe blokowanie domeny
✓ Wsparcie 24/7
✓ Łatwe zarządzanie domenami
✓ Opcja automatycznego odnowy

Najlepsze praktyki zarządzania domenami

Bezpieczeństwo

Włącz blokowanie domeny: Zapobiega nieuprawnionym transferom
Włącz ochronę prywatności: Ukrywa Twoje dane osobowe z WHOIS
Użyj silnych haseł: Ochrona konta VPS.org
Włącz 2FA: Dodaj dodatkowe zabezpieczenie do konta
Monitorowanie terminów ważności: Ustawianie przypomnień automatycznych lub kalendarza

Konfiguracja

Ustawienie DNS: Serwery nazw punktów do VPS.org dla łatwego zarządzania
Automatyczne odnawianie: Włącz, aby zapobiec przypadkowemu ważeniu domeny
Informacje kontaktowe: Uaktualnij dane kontaktowe WHOIS
Zapasowy DNS: Zastanów się nad wtórnym dostawcą DNS w odniesieniu do redundancji

Transfery

60-dniowy zamek: Domena nie może zostać przeniesiona w ciągu 60 dni od rejestracji lub poprzedniego przekazania
Odblokuj domenę: Przed przeniesieniem musi być otwarty w bieżącym rejestrze
Zdobądź kod Auth: Zażądać kodu EPP/autoryzacji od bieżącego rejestru
Sprawdź e- mail: Dostaniesz e-maile do zatwierdzenia podczas procesu transferu
Plan naprzód: Transfery mogą trwać 5-7 dni do zakończenia

VPS.org API

Wyświetl wszystkie domeny

Parametry zapytania

Przykładowe żądanie

Przykładowa odpowiedź

Kody statusu odpowiedzi

Zarejestruj nową domenę

Parametry treści żądania

Przykładowe żądanie

Przykładowa odpowiedź

Kody statusu odpowiedzi

Pobierz szczegóły domeny

Parametry ścieżki

Przykładowe żądanie

Przykładowa odpowiedź

Kody statusu odpowiedzi

Uaktualnij ustawienia domeny

Parametry ścieżki

Parametry treści żądania

Przykładowe żądanie

Przykładowa odpowiedź

Kody statusu odpowiedzi

Usuń domenę

Parametry ścieżki

Przykładowe żądanie

Kody statusu odpowiedzi

Domena transferu

Parametry ścieżki

Parametry treści żądania

Przykładowe żądanie

Przykładowa odpowiedź

Kody statusu odpowiedzi

Cennik wartości domeny

Popularne TDD

Zawarte funkcje

Najlepsze praktyki zarządzania domenami

Bezpieczeństwo

Konfiguracja

Transfery