Li-domains API

Thathamisa Libaka Tsohle

E khutlisa li-domains tse ngotsoeng akhaonteng ea hau, 25 ka leqephe. Lintlha ha li na li-filters.

Litokelo li hlokahale: domains:list

Kopo ea Mohlala

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

Karabo ea Mohlala

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

Masimo a Karabo

Fumana lintlha tsa domain

E khutlisa ntho e le 'ngoe ea domain le libaka tse ka holimo.

Litokelo li hlokahale: domains:list

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

Likhoutu tsa Boemo ba Karabelo

Ho fumaneha ha domain

E hlahloba hore na lebitso le na le ho lekana ka li-extension tse ka bang 20 tse tsebahalang (com, net, org, io, dev, co, app, ai le tse ling), le ho feta ho feta lentsoe le tšoauoang haeba le se teng. Liphetho li qala ka ho kopana ka ho nepahetseng, ka mor'a moo li-name tse fumanehang, ka mor'a moo li-name tse nkang.

Litokelo li hlokahale: domains:search

Kopa Liparamente tsa 'Mele

Kopo ea Mohlala

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

Karabo ea Mohlala

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

The theko ke palo ea USD bakeng sa selemo se le seng le null bakeng sa lebitso le sa fumanehang. The theko e bonts'itsoeng ke ho bonts'a.

Likhoutu tsa Boemo ba Karabelo

Ngolisa Sebaka se Secha sa Marang-rang

E ngolisa domaini'me e lefa tsela ea ho lefa e bolokiloeng. Bongata le theko li tla hlahlojoa le motsamaisi oa ho ngolisa hape pele ho lefa. Lintlha tsa ho ikopanya le motsamaisi oa ho ngolisa li tlatsoa ho tsoa ho ak'haonte ea hau. Haeba motsamaisi oa ho ngolisa a sa lumele ho ngolisoa ka mor'a ho lefa, lefiso le tla khutlisoa.

Litokelo li hlokahale: domains:register (e fanoeng ke li-domains: *)

Kopa Liparamente tsa 'Mele

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

Karabo ea Mohlala

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

Likhoutu tsa Boemo ba Karabelo

Ho khutlisa domain

E nchafatsa domain'me e lefa renewal_price ea eona selemo le selemo ka mokhoa oa ho lefa o bolokiloeng.

Litokelo li hlokahale: domains:renew

Kopa Liparamente tsa 'Mele

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

Likhoutu tsa Boemo ba Karabelo

Ho nchafatsa Nameservers

E beha li-server tsa lebitso la domain ho registrar'me e khutlisa ntho ea domain e nchafalitsoeng. Ho laola DNS ka DNS API, sebelisa ns1.vps.org, ns2.vps.org le ns3.vps.org' me u thehe sebaka sa domain.

Litokelo li hlokahale: domains:update

Kopa Liparamente tsa 'Mele

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

Likhoutu tsa Boemo ba Karabelo

Ho kenya kapa ho tlosa ho nchafatsoa ka ho toba

E beha auto_renew'me e khutlisa ntho ea domain e nchafalitsoeng. E romella e sebetsa e le JSON boolean: lengolo-tsoibila le seng lefifi, ho kenyeletsoa lengolo-tsoibila le fosahetseng, le hokahanya ho nchafatsoa ka ho toba.

Litokelo li hlokahale: 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}'

Likhoutu tsa Boemo ba Karabelo

Litlhaku

• API ha e ka tlosa domain, ho fetisa domain, kapa ho fetola WHOIS privacy kapa ho fetisa lock. Transfers le ho tlosa li fumaneha ka control panel ho admin.vps.org.
• Li-records tsa DNS bakeng sa sebaka se le seng li tsamaisoa ka API ea DNS. API ea Taolo ea DNS