Sritys API

Išvardinti visus domenus

Grįžta į paskyrą užregistruotus domenus, 25 per puslapį. Sąrašas neturi filtrų.

Reikalingas leidimas: domains:list

Prašymo pavyzdys

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

Atsakymo pavyzdys

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

Atsakymo laukai

Gauti domeno informaciją

Grąžina vieną domeno objektą su laukeliais virš.

Reikalingas leidimas: domains:list

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

Atsakymo būsenos kodai

Ieškoti domeno prieinamumo

Patikrina, ar pavadinimas yra prieinamas apie 20 populiarių plėtinių (com, neto, org, io, dev, co, app, ai ir daugiau), plius plėtinys jums įvestą jei jis nėra tarp jų. Rezultatai prasideda su tiksliu atitikimą, tada prieinamas pavadinimus, tada paimti tie.

Reikalingas leidimas: domains:search

Užklausos turinio parametrai

Prašymo pavyzdys

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

Atsakymo pavyzdys

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

Vienerius metus kainos yra USD ir nėra už pavadinimus, kurie nėra prieinami. Pateikiamos kainos yra iliustracinės.

Atsakymo būsenos kodai

Registruoti naują domeną

Registruotojas užregistruoja domeną ir įtraukia į apskaitą savo įrašus. Prieinamumas ir kaina vėl patikrinami registratoriumi prieš tai, kai imamas mokestis. Registruotojas iš Jūsų sąskaitos profilio gauna kontaktinius duomenis. Jei registratorius po mokesčio registracijos atmeta, mokėjimas grąžinamas.

Reikalingas leidimas: domains:register (srityse:*)

Užklausos turinio parametrai

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

Atsakymo pavyzdys

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

Atsakymo būsenos kodai

Atnaujinti domeną

Atnaujina domeno ir mokesčiai jo renovation_price už kiekvienus metus jūsų išsaugotą mokėjimo būdą.

Reikalingas leidimas: domains:renew

Užklausos turinio parametrai

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

Atsakymo būsenos kodai

Atnaujinti vardų serverius

Nustato domeno vardų serverius registratūroje ir grąžina atnaujintą domeno objektą. Norėdami valdyti DNS su DNS API, naudokite ns1.vps.org, ns2.vps.org ir ns3.vps.org ir sukurkite domeno zoną.

Reikalingas leidimas: domains:update

Užklausos turinio parametrai

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

Atsakymo būsenos kodai

Įjungti arba išjungti automatinio atnaujinimo

Nustato automatinį_ atnaujinti ir grąžina atnaujintą domeno objektą. Siųsti įjungtas kaip JSON boolean: bet kokia netuščia eilutė, įskaitant klaidingą eilutę, automatiškai atnaujinama.

Reikalingas leidimas: 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}'

Atsakymo būsenos kodai

Pastabos

• API negali ištrinti domeno, perduoti domeno į WHOIS privatumą arba pakeisti jo užraktą. Perdavimai ir ištrynimai yra prieinami valdymo skydelyje admin.vps.org.
• DNS įrašai domeno yra tvarkomi DNS API. DNS valdymo API