Доменлар API

Barcha domenlarni ro'yxatlash

Ҳисобингизда рўйхатдан ўтган доменларни қайтаради, ҳар бир саҳифада 25 та. Ушбу рўйхатда филтрлар йўқ.

Ҳужжат талаб этилади: domains:list

Namunaviy so'rov

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

Javob namunasi

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

Javob maydonlari

Домен тафсилотларини олиш

Юқоридаги майдонлар билан бир домен объектини қайтаради.

Ҳужжат талаб этилади: domains:list

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

Javob holati kodlari

Домен мавжудлигини қидириш

Ном 20 та машҳур кенгайтирма (com, net, org, io, dev, co, app, ai ва бошқалар) орасида мавжудлигини текширади, агар у улар орасида бўлмаса, сиз ёзган кенгайтирма ҳам. Натижалар аниқ мослашган ном билан бошланади, кейин мавжуд номлар, кейин олинганлар.

Ҳужжат талаб этилади: domains:search

Tana parametrlarini so'rash

Namunaviy so'rov

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

Javob namunasi

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

Нархлар бир йил учун долларда кўрсатилган ва мавжуд бўлмаган номлар учун нульдир. Кўрсатилган нархлар иллюстрация учундир.

Javob holati kodlari

Yangi domenni ro'yxatdan o'tkazing

Доменни рўйхатдан ўтказади ва сизнинг сақланган тўлов усулингизни ҳисобга олади. Қўлланиш имконияти ва нархи тўлов амалга оширилишидан олдин қайтадан регистратор билан текширилади. Регистраторнинг алоқа маълумотлари ҳисобингиз профилидан олинади. Агар регистратор тўлов амалга оширилгандан кейин рўйхатдан ўтказишни рад қилса, тўлов қайтарилади.

Ҳужжат талаб этилади: domains:register (доменлар томонидан берилган:*)

Tana parametrlarini so'rash

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

Javob namunasi

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

Javob holati kodlari

Доменни янгилаш

Доменни янгилайди ва ҳар йили сақланган тўлов усулингизга унинг renewal_price'ини тўлайди.

Ҳужжат талаб этилади: domains:renew

Tana parametrlarini so'rash

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

Javob holati kodlari

Ном серверларини янгилаш

Доменнинг ном серверларини регистраторда ўрнатади ва янгиланган домен объектини қайтаради. DNS API билан DNSни бошқариш учун ns1.vps.org, ns2.vps.org ва ns3.vps.org ни фойдаланинг ва домен учун зона яратинг.

Ҳужжат талаб этилади: domains:update

Tana parametrlarini so'rash

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

Javob holati kodlari

Авто янгилашни ишга тушириш ёки ўчириш

auto_renew параметрини ўрнатади ва янгиланган домен объектини қайтаради. JSON boolean сифатида юбориш ишга туширилган: ҳар қандай бўш бўлмаган string, false string ҳам қўшилган ҳолда, автоматик янгиланишни ишга туширади.

Ҳужжат талаб этилади: 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}'

Javob holati kodlari

Ёдлаш

• API доменни ўчириб ташлай олмайди, доменни кўчира олмайди, WHOIS махфийлигини ёки кўчириш қулфини ўзгартира олмайди. Ўтказиб бериш ва ўчириб ташлашлар admin.vps.org бошқарув панелида мавжуд.
• Домен учун DNS ёзувлари DNS API билан бошқарилади. DNS boshqaruv APIsi