API för domäner

Lista alla domäner

Returnerar domänerna registrerade på ditt konto, 25 per sida. Listan har inga filter.

Krav på tillstånd: domains:list

Exempelförfrågan

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

Exempelsvar

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

Svarsfält

Hämta domändetaljer

Returnerar ett domänobjekt med fälten ovan.

Krav på tillstånd: domains:list

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

Svarsstatuskoder

Tillgängliga sökdomäner

Kontrollerar om ett namn finns tillgängligt över cirka 20 populära tillägg (com, net, org, io, dev, co, app, ai och mer), plus tillägget du skrev om det inte är bland dem. Resultat börjar med exakt matchning, sedan tillgängliga namn, sedan tagna.

Krav på tillstånd: domains:search

Parametrar för begäran

Exempelförfrågan

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

Exempelsvar

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

Priserna är siffror i USD för ett år och är noll för namn som inte är tillgängliga. Priserna som visas är belysande.

Svarsstatuskoder

Registrera ny domän

Registrerar en domän och debiterar din sparade betalningsmetod. Tillgänglighet och pris kontrolleras med registratorn igen precis före avgiften. Kontaktuppgifter till registranten hämtas från din kontoprofil. Om registratorn avvisar registreringen efter avgiften återbetalas betalningen.

Krav på tillstånd: domains:register (beviljas av domäner:*)

Parametrar för begäran

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

Exempelsvar

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

Svarsstatuskoder

Förnya ett domänområde

Förnyar domänen och debiterar dess förnyelsepris för varje år till din sparade betalningsmetod.

Krav på tillstånd: domains:renew

Parametrar för begäran

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)!"
}

Svarsstatuskoder

Uppdatera namnservrar

Ställer in domänens namnservrar vid registraren och returnerar det uppdaterade domänobjektet. För att hantera DNS med DNS- API:et, använd ns1.vps.org, ns2.vps.org och ns3.vps.org och skapa en zon för domänen.

Krav på tillstånd: domains:update

Parametrar för begäran

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

Svarsstatuskoder

Aktivera automatisk förnyelse eller avstängning

Ställer in auto_reny och returnerar det uppdaterade domänobjektet. Skicka aktiverad som en JSON boolean: varje sträng som inte är tom, inklusive strängen som är falsk, vänder automatiskt på förnyelsen.

Krav på tillstånd: 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}'

Svarsstatuskoder

Anmärkningar

• API:et kan inte ta bort en domän, överföra en domän i, eller ändra WHOIS-integritet eller överföringslås. Överföringar och borttagning finns i kontrollpanelen på admin.vps.org.
• DNS-poster för en domän hanteras med DNS API. DNS-hanterings-API