Domēna API

Uzskaitīt visus domēnus

Atgriež domēni reģistrēti jūsu kontā, 25 par lapu. Sarakstam nav filtru.

Nepieciešamā atļauja: domains:list

Pieprasījuma piemērs

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

Atbildes piemērs

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

Atbildes lauki

Iegūst domēna detaļas

Atgriež vienu domēna objektu ar laukiem.

Nepieciešamā atļauja: domains:list

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

Atbildes statusa kodi

Meklēšanas domēna pieejamība

Pārbauda, vai nosaukums ir pieejams aptuveni 20 populārs paplašinājumi (com, neto, org, io, dev, co, app, ai un vairāk), plus paplašinājums jums ierakstīja, ja tas nav starp tiem. Rezultāti sākas ar precīzu spēli, tad pieejami nosaukumi, tad ņem tos.

Nepieciešamā atļauja: domains:search

Pieprasījuma pamatteksta parametri

Pieprasījuma piemērs

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

Atbildes piemērs

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

Cenas ir USD numuri vienu gadu un nav pieejami nosaukumi. Cenas parādītas ilustratīvi.

Atbildes statusa kodi

Reģistrēt jaunu domēnu

Reģistrē jūsu saglabāto maksājumu veidu un domēnu. Pieejamība un cena tiek pārbaudīta ar reģistratoru, pirms maksas. Reģistrētāja kontaktinformācija tiek ņemta no jūsu konta profila. Ja reģistrētājs noraida reģistrāciju pēc maksas, maksājums tiek atmaksāts.

Nepieciešamā atļauja: domains:register (piešķir domēni:*)

Pieprasījuma pamatteksta parametri

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

Atbildes piemērs

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

Atbildes statusa kodi

Atsvaidzināt domēnu

Atjauno domēnu un maksā tās retrocesion_cena par katru gadu jūsu saglabāto maksājumu metodi.

Nepieciešamā atļauja: domains:renew

Pieprasījuma pamatteksta parametri

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

Atbildes statusa kodi

Atjaunināt nosaukumusCervers

Iestata domēna vārdu serveras pie reģistrara un atgriež atjaunoto domēna objektu. Lai pārvaldītu DNS ar DNS API, izmantojiet ns1.vps.org, ns2.vps.org un ns3.vps.org un izveidojiet domēna zonu.

Nepieciešamā atļauja: domains:update

Pieprasījuma pamatteksta parametri

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

Atbildes statusa kodi

Ieslēgt vai izslēgt automātisku atjaunošanu

Iestata_ renew un atgriež atjaunoto domēna objektu. Sūta ieslēgtu kā JSON boolean: jebkura netukša virkne, ieskaitot rindu melnumu, pārvērš automātiski atjaunot.

Nepieciešamā atļauja: 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}'

Atbildes statusa kodi

Piezīmes

• API nevar dzēst domēnu, pārsūtīt domēnu vai mainīt WHOIS konfidencialitāti vai transfēra slēdzeni. Pārsūtījumi un dzēšana ir pieejama vadības panelī admin.vps.org.
• DNS ieraksti domēnam tiek pārvaldīti ar DNS API. DNS pārvaldības API