Domains API

Liste over alle domæner

Returnerer de domæner, der er registreret på din konto, 25 pr. side. Listen har ingen filtre.

Krævet tilladelse: domains:list

Eksempel på anmodning

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

Eksempel på svar

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

Svarfelter

Få domænedetaljer

Returnerer et domæneobjekt med felterne ovenfor.

Krævet tilladelse: domains:list

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

Svarstatuskoder

Søg domæne Tilgængelighed

Kontrollerer, om et navn er tilgængeligt på tværs af omkring 20 populære udvidelser (com, netto, org, io, dev, co, app, ai og mere), plus den udvidelse, du indtastede, hvis det ikke er blandt dem. Resultater starter med den nøjagtige match, så tilgængelige navne, derefter taget dem.

Krævet tilladelse: domains:search

Parametre for anmodningstekst

Eksempel på anmodning

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"])

Eksempel på svar

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

Priserne er tal i USD for et år og er nul for navne, der ikke er tilgængelige. De viste priser er illustrative.

Svarstatuskoder

Registrer nyt domæne

Registrerer et domæne og opkræver din gemte betalingsmetode. Tilgængelighed og pris kontrolleres igen hos registratoren lige før afgiften. Kontaktoplysningerne for registranten tages fra din kontoprofil. Hvis registratoren afviser registreringen efter gebyret, refunderes betalingen.

Krævet tilladelse: domains:register (tildelt af områder:*)

Parametre for anmodningstekst

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}'

Eksempel på svar

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

Svarstatuskoder

Forny et domæne

Fornyer domænet og opkræver sin fornyelse_pris for hvert år til din gemte betalingsmetode.

Krævet tilladelse: domains:renew

Parametre for anmodningstekst

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

Opdatér navneservere

Indstiller domænets navneservere ved registratoren og returnerer det opdaterede domæneobjekt. For at administrere DNS med DNS API, skal du bruge ns1.vps.org, ns2.vps.org og ns3.vps.org og oprette en zone for domænet.

Krævet tilladelse: domains:update

Parametre for anmodningstekst

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å automatisk fornyelse til eller fra

Sætter auto_ renew og returnerer det opdaterede domæneobjekt. Send aktiveret som en JSON- boolean: enhver ikke- tom streng, herunder strengen falsk, tænder automatisk fornyelse.

Krævet tilladelse: 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

Bemærkninger

• API'en kan ikke slette et domæne, overføre et domæne i eller ændre WHOIS' privatliv eller overførselslåsen. Overførsler og sletning er tilgængelige i kontrolpanelet på admin.vps.org.
• DNS-poster til et domæne styres med DNS API. DNS-administrations-API