Domene- API

BLI /api/v1/domains/

List opp alle domener

Hent en liste over alle domener som er registrert på kontoen din.

Spørringsparametere

Parameter	Type	Obligatorisk	Beskrivelse
`status`	string	Nei	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Nei	Søk etter domener etter navn

Eksempelforespørsel

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

Eksempelsvar

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

Svarstatuskoder

200	Domenelisten er hentet
401	Uautorisert – Ugyldig eller manglende autentiseringstoken

POST /api/v1/domains/

Registrer nytt domene

Registrer et nytt domenenavn. Domenetilgjengelighet bør sjekkes før registrering.

Forespørselsparametere

Parameter	Type	Obligatorisk	Beskrivelse
`domain_name`	string	Ja	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)

Eksempelforespørsel

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

Eksempelsvar

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

Svarstatuskoder

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Uautorisert – Ugyldig eller manglende autentiseringstoken
402	Payment Required - Insufficient account balance

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

BLI /api/v1/domains/{domain_id}/

Hent domenedetaljer

Hent detaljert informasjon om et bestemt domene.

Baneparametere

Parameter	Type	Obligatorisk	Beskrivelse
`domain_id`	integer	Ja	Unique domain ID

Eksempelforespørsel

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

Eksempelsvar

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

Svarstatuskoder

200	Successfully retrieved domain details
401	Uautorisert – Ugyldig eller manglende autentiseringstoken
404	Ikke funnet – Domenet finnes ikke

SETTE /api/v1/domains/{domain_id}/

Oppdater domeneinnstillinger

Oppdater domeneoppsettet slik som automatisk fornyelse, navnetjenere og personverninnstillinger.

Baneparametere

Parameter	Type	Obligatorisk	Beskrivelse
`domain_id`	integer	Ja	Unique domain ID

Forespørselsparametere

Parameter	Type	Obligatorisk	Beskrivelse
`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

Eksempelforespørsel

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

Eksempelsvar

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

Svarstatuskoder

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Uautorisert – Ugyldig eller manglende autentiseringstoken
404	Ikke funnet – Domenet finnes ikke

SLETT /api/v1/domains/{domain_id}/

Slett domene

Slett et domene fra kontoen din. Dette opphever ikke domeneregistreringen – det fjerner det bare fra din VPS.org kontobehandling.

Baneparametere

Parameter	Type	Obligatorisk	Beskrivelse
`domain_id`	integer	Ja	Unique domain ID

Eksempelforespørsel

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

Svarstatuskoder

204	Domain removed from account successfully
401	Uautorisert – Ugyldig eller manglende autentiseringstoken
404	Ikke funnet – Domenet finnes ikke

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/

Overføringsdomene

Initiate a domain transfer to VPS.org from another registrar.

Baneparametere

Parameter	Type	Obligatorisk	Beskrivelse
`domain_id`	integer	Ja	Unique domain ID

Forespørselsparametere

Parameter	Type	Obligatorisk	Beskrivelse
`auth_code`	string	Ja	EPP/Authorization code from current registrar
`auto_renew`	boolean	Nei	Enable auto-renewal after transfer (default: true)

Eksempelforespørsel

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

Eksempelsvar

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

Svarstatuskoder

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Uautorisert – Ugyldig eller manglende autentiseringstoken
404	Ikke funnet – Domenet finnes ikke
402	Payment Required - Insufficient account balance for transfer fee

Overføringskrav:

Domeneet må låses opp ved gjeldende registrator
Domeneet må være minst 60 dager gammelt.
Krav om gyldig PPE-/godkjenningskode
WHOIS-e-post skal være tilgjengelig for godkjenning
Overføring omfatter ettårig fornyelse (fee gjelder)

Domenepriser

Populære TLD- er

TLD	Registrering (1 år)	Fornyelse	Overføring
.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

Inkluderte funksjoner

✓ Vern av personvernet til fri WHOIS
✓ Fri DNS- håndtering
✓ Gratis videresending av e- post
✓ Videresending av fridomene

✓ Låsing av frie domener
✓ 24/7 Støtte
✓ Lett domenestyring
✓ Autofornyelsesvalg

Beste praksis for forvaltning av domener

Sikkerhet

Slå på domenelåsing: Hindrer uautoriserte overføringer
Slå på personvern: Skjuler dine personlige opplysninger for WHOIS
Bruk sterke passord: Beskytt din VPS.org konto
Slå på 2FA: Legg til ekstra sikkerhet på kontoen din
Utløpsdatoer for overvåking: Sett opp automatisk fornyelse eller kalenderpåminnelser@ info: whatsthis

Oppsett

DNS- oppsett: Peketjenere til VPS.org for enkel håndtering
Automatisk fornyelse: Slå på for å hindre utilsiktet utløp av domene
Kontaktinformasjon: Hold WHOIS- kontaktinformasjon oppdatert
Sikkerhetskopier DNS: Se på sekundær DNS- leverandør for redundans

Overføringer

60- dagers lås: Domene kan ikke overføres innen 60 dager etter registrering eller tidligere overføring
Lås opp domene: Må låses opp ved gjeldende registrator før overføring
Hent autentiseringskode: Anmodning om PPE-/godkjenningskode fra gjeldende registrator
Sjekk e- post: Du får godkjenningsmeldinger under overføringsprosessen
Planframover: Overføringer kan ta 5-7 dager å fullføre

VPS.org API

List opp alle domener

Spørringsparametere

Eksempelforespørsel

Eksempelsvar

Svarstatuskoder

Registrer nytt domene

Forespørselsparametere

Eksempelforespørsel

Eksempelsvar

Svarstatuskoder

Hent domenedetaljer

Baneparametere

Eksempelforespørsel

Eksempelsvar

Svarstatuskoder

Oppdater domeneinnstillinger

Baneparametere

Forespørselsparametere

Eksempelforespørsel

Eksempelsvar

Svarstatuskoder

Slett domene

Baneparametere

Eksempelforespørsel

Svarstatuskoder

Overføringsdomene

Baneparametere

Forespørselsparametere

Eksempelforespørsel

Eksempelsvar

Svarstatuskoder

Domenepriser

Populære TLD- er

Inkluderte funksjoner

Beste praksis for forvaltning av domener

Sikkerhet

Oppsett

Overføringer