Verkkoaluerajapinta

SAADA /api/v1/domains/

Listaa kaikki verkkotunnukset

Hae lista kaikista tilillesi rekisteröidyistä verkkotunnuksista.

Kyselyparametrit

Muuttuja	Tyyppi	Pakollinen	Tavaran kuvaus
`status`	string	Ei tarvitse.	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Ei tarvitse.	Hae verkkotunnuksia nimen perusteella

Esimerkkipyyntö

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

Esimerkkivastaus

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

Vastauksen tilakoodit

200	Verkkotunnusluettelo noudettu onnistuneesti
401	Luvaton - Virheellinen tai puuttuva todennustunnus

JÄLKEEN /api/v1/domains/

Rekisteröi uusi verkkotunnus

Rekisteröi uusi verkkotunnus. Verkkoalueen saatavuus tulee tarkistaa ennen rekisteröintiä.

Pyynnön rungon parametrit

Muuttuja	Tyyppi	Pakollinen	Tavaran kuvaus
`domain_name`	string	Kyllä	Domain name to register (e.g., "example.com")
`years`	integer	Ei tarvitse.	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	Ei tarvitse.	Enable automatic renewal (default: true)
`privacy_protection`	boolean	Ei tarvitse.	Enable WHOIS privacy protection (default: true)
`nameservers`	array	Ei tarvitse.	Custom nameservers (default: VPS.org nameservers)

Esimerkkipyyntö

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

Esimerkkivastaus

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

Vastauksen tilakoodit

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Luvaton - Virheellinen tai puuttuva todennustunnus
402	Payment Required - Insufficient account balance

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

SAADA /api/v1/domains/{domain_id}/

Hanki verkkotunnuksen tiedot

Hae yksityiskohtaisia tietoja tietystä verkkoalueesta.

Polkuparametrit

Muuttuja	Tyyppi	Pakollinen	Tavaran kuvaus
`domain_id`	integer	Kyllä	Unique domain ID

Esimerkkipyyntö

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

Esimerkkivastaus

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

Vastauksen tilakoodit

200	Successfully retrieved domain details
401	Luvaton - Virheellinen tai puuttuva todennustunnus
404	Ei löydy - Verkkotunnusta ei ole olemassa

LAITTAA /api/v1/domains/{domain_id}/

Päivitä verkkotunnuksen asetukset

Päivitä verkkotunnuksen asetukset, kuten automaatti-uudistukset, nimipalvelimet ja yksityisyysasetukset.

Polkuparametrit

Muuttuja	Tyyppi	Pakollinen	Tavaran kuvaus
`domain_id`	integer	Kyllä	Unique domain ID

Pyynnön rungon parametrit

Muuttuja	Tyyppi	Pakollinen	Tavaran kuvaus
`auto_renew`	boolean	Ei tarvitse.	Enable or disable automatic renewal
`privacy_protection`	boolean	Ei tarvitse.	Enable or disable WHOIS privacy
`nameservers`	array	Ei tarvitse.	Update nameservers (2-4 nameservers required)
`locked`	boolean	Ei tarvitse.	Lock or unlock domain to prevent transfers

Esimerkkipyyntö

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

Esimerkkivastaus

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

Vastauksen tilakoodit

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Luvaton - Virheellinen tai puuttuva todennustunnus
404	Ei löydy - Verkkotunnusta ei ole olemassa

POISTAA /api/v1/domains/{domain_id}/

Poista verkkoalue

Poista verkkotunnus tililtäsi. Tämä ei peruuta verkkotunnuksen rekisteröintiä - se poistaa sen vain VPS.org tililtäsi.

Polkuparametrit

Muuttuja	Tyyppi	Pakollinen	Tavaran kuvaus
`domain_id`	integer	Kyllä	Unique domain ID

Esimerkkipyyntö

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

Vastauksen tilakoodit

204	Domain removed from account successfully
401	Luvaton - Virheellinen tai puuttuva todennustunnus
404	Ei löydy - Verkkotunnusta ei ole olemassa

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.

JÄLKEEN /api/v1/domains/{domain_id}/transfer/

Siirtoverkkoalue

Aloita verkkotunnuksen siirto VPS.org:een toiselta rekisteröijältä.

Polkuparametrit

Muuttuja	Tyyppi	Pakollinen	Tavaran kuvaus
`domain_id`	integer	Kyllä	Unique domain ID

Pyynnön rungon parametrit

Muuttuja	Tyyppi	Pakollinen	Tavaran kuvaus
`auth_code`	string	Kyllä	EPP/Authorization code from current registrar
`auto_renew`	boolean	Ei tarvitse.	Enable auto-renewal after transfer (default: true)

Esimerkkipyyntö

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

Esimerkkivastaus

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

Vastauksen tilakoodit

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Luvaton - Virheellinen tai puuttuva todennustunnus
404	Ei löydy - Verkkotunnusta ei ole olemassa
402	Payment Required - Insufficient account balance for transfer fee

Siirtovaatimukset:

Verkkoalue on avattava nykyisessä rekisterissä
Verkkoalueen on oltava vähintään 60 päivää vanha
Voimassa oleva EPP/Auth-koodi vaaditaan
Whois-sähköpostin on oltava saatavilla hyväksyntää varten
Siirto sisältää yhden vuoden uusimisen (maksua sovelletaan)

Verkkoalueen hinnoittelu

Suosittuja etälamauttimia

TLD	Rekisteröinti (1 vuosi)	Uudistaminen	Siirto
.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

Sisältyvät ominaisuudet

✓ Vapaa WHOIS-tietosuoja
✓ Ilmaista DNS-hallintaa
✓ Ilmainen sähköpostin välittäminen
✓ Vapaat verkkotunnukset eteenpäin

✓ Vapaa verkkoalueen lukitus
✓ 24/7-tuki
✓ Helppo verkkoalueen hallinta
✓ Automaattisesti uusittava vaihtoehto

Verkkoalueen hallinnan parhaat käytännöt

Turvallisuus

Käytä verkkoalueen lukitusta: Estää luvattomat siirrot
Ota Privacy Protection käyttöön: Piilottaa henkilökohtaiset tietosi Whois'lta
Käytä vahvoja salasanoja: Suojaa VPS.org-tilisi
Käytä 2FA:ta: Lisää lisäturvaa tilillesi
Valvo voimassaolon päättymispäivää: Aseta automaattiset uusinta- tai kalenterimuistutukset

Asetukset

DNS-asetus: Osoita nimipalvelimet VPS.org:een helppoon johtamiseen
Automaattinen uusiminen: Ota käyttöön verkkotunnuksen vanhentumisen estäminen
Yhteystiedot: Pidä Whois-yhteystiedot ajan tasalla
Varmuuskopiointi DNS: Harkitkaa toissijaista DNS-palvelujen tarjoajaa irtisanomisen varalta

Siirrot

60 päivän lukko: Verkkoalueita ei voi siirtää 60 päivän kuluessa rekisteröinnistä tai aiemmasta siirrosta
Avaa verkkoalue: On oltava auki nykyisessä rekisterissä ennen siirtoa
Hae Auth-koodi: Pyytää EPP/valtuutuskoodia nykyiseltä rekisteröijältä
Tarkista sähköposti: Saat hyväksymissähköposteja siirtoprosessin aikana
Suunnitelma edessä: Siirtojen suorittaminen voi kestää 5-7 päivää

VPS.org API

Verkkoaluerajapinta

Listaa kaikki verkkotunnukset

Kyselyparametrit

Esimerkkipyyntö

Esimerkkivastaus

Vastauksen tilakoodit

Rekisteröi uusi verkkotunnus

Pyynnön rungon parametrit

Esimerkkipyyntö

Esimerkkivastaus

Vastauksen tilakoodit

Hanki verkkotunnuksen tiedot

Polkuparametrit

Esimerkkipyyntö

Esimerkkivastaus

Vastauksen tilakoodit

Päivitä verkkotunnuksen asetukset

Polkuparametrit

Pyynnön rungon parametrit

Esimerkkipyyntö

Esimerkkivastaus

Vastauksen tilakoodit

Poista verkkoalue

Polkuparametrit

Esimerkkipyyntö

Vastauksen tilakoodit

Siirtoverkkoalue

Polkuparametrit

Pyynnön rungon parametrit

Esimerkkipyyntö

Esimerkkivastaus

Vastauksen tilakoodit

Verkkoalueen hinnoittelu

Suosittuja etälamauttimia

Sisältyvät ominaisuudet

Verkkoalueen hallinnan parhaat käytännöt

Turvallisuus

Asetukset

Siirrot