Domains API

FÁ /api/v1/domains/

Listi yfir öll lén

Sækja lista yfir öll lén sem eru skráð undir reikningnum þínum.

Fyrirspurnarbreytur

Breyta	Tegund	Nauðsynlegt	Lýsing
`status`	string	Nei	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Nei	Leita að lénum eftir nafni

Dæmi um beiðni

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

Dæmi um svar

{
  "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óðar fyrir svörunarstöðu

200	Listi yfir lén sóttur
401	Óheimilt - Ógilt eða vantar auðkenningarlykil

POST /api/v1/domains/

Skrá nýtt lén

Skrá nýtt lén. Athugaðu hvort lénið sé tiltækt áður en þú skráir það.

Færibreytur beiðninnar

Breyta	Tegund	Nauðsynlegt	Lýsing
`domain_name`	string	Já	Domain name to register (e.g., "example.com")
`years`	integer	Nei	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	Nei	Enable automatic renewal (default: true)
`privacy_protection`	boolean	Nei	Enable WHOIS privacy protection (default: true)
`nameservers`	array	Nei	Custom nameservers (default: VPS.org nameservers)

Dæmi um beiðni

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

Dæmi um svar

{
  "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óðar fyrir svörunarstöðu

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Óheimilt - Ógilt eða vantar auðkenningarlykil
402	Payment Required - Insufficient account balance

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

FÁ /api/v1/domains/{domain_id}/

Fá upplýsingar um lén

Sækja nákvæmar upplýsingar um tiltekið lén.

Slóðarbreytur

Breyta	Tegund	Nauðsynlegt	Lýsing
`domain_id`	integer	Já	Unique domain ID

Dæmi um beiðni

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

Dæmi um svar

{
  "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óðar fyrir svörunarstöðu

200	Successfully retrieved domain details
401	Óheimilt - Ógilt eða vantar auðkenningarlykil
404	Finnst ekki - Lénið er ekki til

SETJA /api/v1/domains/{domain_id}/

Uppfæra lén

Uppfærðu stillingar léns eins og sjálfvirka endurnýjun, nafnþjóna og persónuverndarstillingar.

Slóðarbreytur

Breyta	Tegund	Nauðsynlegt	Lýsing
`domain_id`	integer	Já	Unique domain ID

Færibreytur beiðninnar

Breyta	Tegund	Nauðsynlegt	Lýsing
`auto_renew`	boolean	Nei	Enable or disable automatic renewal
`privacy_protection`	boolean	Nei	Enable or disable WHOIS privacy
`nameservers`	array	Nei	Update nameservers (2-4 nameservers required)
`locked`	boolean	Nei	Lock or unlock domain to prevent transfers

Dæmi um beiðni

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

Dæmi um svar

{
  "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óðar fyrir svörunarstöðu

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Óheimilt - Ógilt eða vantar auðkenningarlykil
404	Finnst ekki - Lénið er ekki til

EYÐA /api/v1/domains/{domain_id}/

Eyða léni

Eyða léni af reikningnum þínum. Þetta hættir ekki við skráningu lénsins - það fjarlægir það aðeins úr VPS.org reikningsstjórnuninni þinni.

Slóðarbreytur

Breyta	Tegund	Nauðsynlegt	Lýsing
`domain_id`	integer	Já	Unique domain ID

Dæmi um beiðni

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óðar fyrir svörunarstöðu

204	Domain removed from account successfully
401	Óheimilt - Ógilt eða vantar auðkenningarlykil
404	Finnst ekki - Lénið er ekki til

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/

Flytja lén

Hefja lén flytja til VPS.org frá öðrum skrásetjara.

Slóðarbreytur

Breyta	Tegund	Nauðsynlegt	Lýsing
`domain_id`	integer	Já	Unique domain ID

Færibreytur beiðninnar

Breyta	Tegund	Nauðsynlegt	Lýsing
`auth_code`	string	Já	EPP/Authorization code from current registrar
`auto_renew`	boolean	Nei	Enable auto-renewal after transfer (default: true)

Dæmi um beiðni

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

Dæmi um svar

{
  "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óðar fyrir svörunarstöðu

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Óheimilt - Ógilt eða vantar auðkenningarlykil
404	Finnst ekki - Lénið er ekki til
402	Payment Required - Insufficient account balance for transfer fee

Flutningskröfur:

Lénið verður að vera opið hjá núverandi skrásetjara
Lénið verður að vera að minnsta kosti 60 daga gamalt
Gildan EPP/Auth kóða þarf
WHOIS netfang verður að vera aðgengilegt til samþykktar
Flutningur felur í sér 1 árs endurnýjun (gjald gildir)

Verðlagning léna

Vinsæl TLD

TLD	Skráning (1 ár)	Endurnýjun	Flytja inn
.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

Innifalin atriði

✓ Ókeypis WHOIS persónuvernd
✓ Frjáls DNS stjórnun
✓ Frjáls Email framsending
✓ Ókeypis lénsframsending

✓ Ókeypis lén læsa
✓ 24/7 þjónusta við viðskiptavini
✓ Easy Domain stjórnun
✓ Sjálfvirk endurnýjun valkostur

Bestu starfsvenjur í lénastjórnun

Öryggi

Virkja læsingu léns: Kemur í veg fyrir óheimila flutninga
Virkja persónuvernd: Fela persónulegar upplýsingar frá WHOIS
Notaðu sterk lykilorð: Verndaðu VPS.org reikninginn þinn
Virkja 2FA: Bættu við aukaöryggi á reikninginn þinn
Fylgjast með gildistíma: Setja upp sjálfvirka endurnýjun eða dagbókar áminningar

Stillingar

DNS stillingar: Benda nafnþjóna til VPS.org til að auðvelda stjórnun
Sjálfvirk endurnýjun: Virkja til að koma í veg fyrir að lén renni út fyrir slysni
Upplýsingar um tengiliði: Haltu WHOIS tengiliðaupplýsingum uppfærðum
Afritun DNS: Íhugaðu auka DNS þjónustuveitanda fyrir óþarfa

Flytja inn

60 daga læsing: Ekki er hægt að flytja lén innan 60 daga frá skráningu eða fyrri flutningi
Aflæsa léni: Verður að vera opið á núverandi skrásetjara fyrir flutning
Fá auðkenniskóða: Beiðni um EPP / heimildarkóða frá núverandi skrásetjara
Athugaðu netfang: Þú færð samþykkispóst meðan á flutningsferlinu stendur
Skipuleggja fyrirfram: Það getur tekið 5-7 daga að ljúka millifærslu

VPS.org API

Listi yfir öll lén

Fyrirspurnarbreytur

Dæmi um beiðni

Dæmi um svar

Kóðar fyrir svörunarstöðu

Skrá nýtt lén

Færibreytur beiðninnar

Dæmi um beiðni

Dæmi um svar

Kóðar fyrir svörunarstöðu

Fá upplýsingar um lén

Slóðarbreytur

Dæmi um beiðni

Dæmi um svar

Kóðar fyrir svörunarstöðu

Uppfæra lén

Slóðarbreytur

Færibreytur beiðninnar

Dæmi um beiðni

Dæmi um svar

Kóðar fyrir svörunarstöðu

Eyða léni

Slóðarbreytur

Dæmi um beiðni

Kóðar fyrir svörunarstöðu

Flytja lén

Slóðarbreytur

Færibreytur beiðninnar

Dæmi um beiðni

Dæmi um svar

Kóðar fyrir svörunarstöðu

Verðlagning léna

Vinsæl TLD

Innifalin atriði

Bestu starfsvenjur í lénastjórnun

Öryggi

Stillingar

Flytja inn