Domene- API

List opp alle domener

Returnerer domenene som er registrert på kontoen din, 25 pr. side. Lista har ingen filtre.

Påkrevd tillatelse: domains:list

Eksempelforespørsel

curl -X GET "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for domain in response.json()["results"]:
    print(domain["domain_name"], domain["status"], domain["expiration_date"])

const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

Eksempelsvar

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
      "domain_name": "example.com",
      "status": "active",
      "registrar": "dynadot",
      "registration_date": "2026-01-15T10:30:00Z",
      "expiration_date": "2027-01-15T10:30:00Z",
      "days_until_expiration": 122,
      "is_expired": false,
      "needs_renewal_soon": false,
      "auto_renew": true,
      "renewal_period_years": 1,
      "registration_price": "12.64",
      "renewal_price": "12.64",
      "whois_privacy": true,
      "nameserver1": "ns1.vps.org",
      "nameserver2": "ns2.vps.org",
      "nameserver3": "ns3.vps.org",
      "nameserver4": null,
      "transfer_lock": true,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-09-01T08:12:40Z"
    }
  ]
}

Svarfelt

Hent domenedetaljer

Returnerer ett domeneobjekt med feltene over.

Påkrevd tillatelse: domains:list

curl -X GET "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Svarstatuskoder

Tilgjengelighet for søkedomene

Sjekker om et navn finnes på tvers av ca. 20 populære utvidelser (com, net, org, io, dev, co, app, ai og mer) pluss etternavnet du skrev inn hvis det ikke er blant dem. Resultatene starter med det eksakte, så tilgjengelige navn, og tok så et navn.

Påkrevd tillatelse: domains:search

Forespørselsparametere

Eksempelforespørsel

curl -X POST "https://admin.vps.org/api/v1/domains/search/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.com"}'

import requests

url = "https://admin.vps.org/api/v1/domains/search/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.post(url, headers=headers, json={"domain": "mysite.com"})
for result in response.json()["results"]:
    if result["available"]:
        print(result["domain"], result["registration_price"], result["renewal_price"])

Eksempelsvar

{
  "results": [
    {
      "domain": "mysite.com",
      "available": false,
      "price": null,
      "registration_price": null,
      "renewal_price": null,
      "tld": "com",
      "is_exact_match": true
    },
    {
      "domain": "mysite.dev",
      "available": true,
      "price": 17.24,
      "registration_price": 17.24,
      "renewal_price": 17.24,
      "tld": "dev",
      "is_exact_match": false
    }
  ],
  "base_domain": "mysite",
  "search_count": 20
}

Prisene er tall i USD for ett år og er null for navn som ikke er tilgjengelige. Prisene som vises er illustrerende.

Svarstatuskoder

Registrer nytt domene

Registrerer et domene og krever betaling for din lagrede betalingsmetode. Tilgjengelighet og pris sjekkes med registratoren igjen rett før avgiften. Registrators kontaktopplysninger tas fra din kontoprofil. Hvis registratoren avviser registreringen etter avgiften, blir betalingen tilbakebetalt.

Påkrevd tillatelse: domains:register (inndelt etter område:*)

Forespørselsparametere

curl -X POST "https://admin.vps.org/api/v1/domains/register/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.dev", "years": 1}'

Eksempelsvar

{
  "success": true,
  "domain_uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
  "domain_name": "mysite.dev",
  "message": "mysite.dev registered successfully!"
}

Svarstatuskoder

Forny et domene

Fornyer domenet og krever for hvert år fornyer du din lagrede betalingsmetode.

Påkrevd tillatelse: domains:renew

Forespørselsparametere

curl -X POST "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/renew/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"years": 1}'

{
  "success": true,
  "domain_uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
  "new_expiration": "2028-01-15T10:30:00+00:00",
  "message": "example.com renewed successfully for 1 year(s)!"
}

Svarstatuskoder

Oppdater navnetjenere

Setter domenets navnetjenere i registraren og returnerer det oppdaterte domeneobjektet. For å håndtere DNS med DNS API, bruk ns1.vps.org, ns2.vps.org og ns3.vps.org og opprett en sone for domenet.

Påkrevd tillatelse: domains:update

Forespørselsparametere

curl -X PUT "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/nameservers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"nameserver1": "ns1.vps.org", "nameserver2": "ns2.vps.org", "nameserver3": "ns3.vps.org"}'

Svarstatuskoder

Slå på eller av automatisk fornyelse

Setter automatisk _fornyelse og returnerer det oppdaterte domeneobjektet. Send slått på som JSON boolsk: enhver streng som ikke er tom, medregnet strengen False slår automatisk på fornyelse.

Påkrevd tillatelse: domains:update

curl -X PUT "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/auto-renew/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Svarstatuskoder

Merknader

• API kan ikke slette et domene, overføre et domene i, eller endre WHOIS personvern eller overføringslåsen. Overføringer og sletting er tilgjengelig i kontrollpanelet på admin.vps.org.
• DNS-poster for et domene blir håndtert med DNS API. DNS-administrasjons-API