Domains API

Listi yfir öll lén

Sýnir lénin sem eru skráð á reikningnum þínum, 25 á síðu. Listinn hefur engar síur.

Nauðsynlegt leyfi: domains:list

Dæmi um beiðni

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

Dæmi um 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"
    }
  ]
}

Svarsvið

Fá upplýsingar um lén

Skila einn lén hlut með sviðum hér að ofan.

Nauðsynlegt leyfi: domains:list

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

Kóðar fyrir svörunarstöðu

Leita að léni

Athugar hvort heiti sé tiltækt á um 20 vinsælum endingum (com, net, org, io, dev, co, app, ai og fleiri), auk viðbótar sem þú slóst inn ef hún er ekki á meðal þeirra. Niðurstöður byrja með nákvæmri samsvörun, síðan tiltækum nöfnum, síðan tekin nöfnum.

Nauðsynlegt leyfi: domains:search

Færibreytur beiðninnar

Dæmi um beiðni

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

Dæmi um 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
}

Verð eru tölur í USD fyrir eitt ár og eru núll fyrir nöfn sem eru ekki í boði.Verð sem sýnd eru eru til skýringar.

Kóðar fyrir svörunarstöðu

Skrá nýtt lén

Skráðir lén og gjaldfærir með þeim greiðslumáta sem þú hefur vistað. Tilboð og verð eru skoðuð hjá skrásetjaranum aftur rétt áður en gjaldfært er. Tengiliðaupplýsingar skrásetjarans eru teknar úr prófílnum þínum. Ef skrásetjari hafnar skráningunni eftir gjaldfærslu er greiðslunni skilað.

Nauðsynlegt leyfi: domains:register (gefið af lénum:*)

Færibreytur beiðninnar

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

Dæmi um svar

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

Kóðar fyrir svörunarstöðu

Endurnýja lén

Endurnýjar lénið og innheimtir endurnýjunarverð fyrir hvert ár með vistaðri greiðsluaðferð þinni.

Nauðsynlegt leyfi: domains:renew

Færibreytur beiðninnar

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

Kóðar fyrir svörunarstöðu

Uppfæra nafnþjóna

Setja nafnþjóna lénsins hjá skrásetjaranum og skila uppfærðu léninu. Til að stjórna DNS með DNS API, notaðu ns1. vps.org, ns2. vps.org og ns3. vps.org og búðu til svæði fyrir lénið.

Nauðsynlegt leyfi: domains:update

Færibreytur beiðninnar

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

Kóðar fyrir svörunarstöðu

Kveikja eða slökkva á sjálfvirkri endurnýjun

Setur auto_renew og skilar uppfærðu léninu. Send enabled as a JSON boolean: any non-empty string, including the string false, turns on auto-renew.

Nauðsynlegt leyfi: 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}'

Kóðar fyrir svörunarstöðu

Athugasemdir

• API getur ekki eytt léni, flutt lén inn, eða breytt WHOIS persónuvernd eða flytja læsingu.Flyting og eytt er í boði í stjórnborðinu á admin.vps.org.
• DNS skrár fyrir lén eru stjórnað með DNS API. DNS stjórnun API