Domenlər

Bütün Domenləri Siyahıya Alın

Hesabınızda qeydiyyatdan keçmiş domenləri geri qaytarır, səhifə başına 25. Siyahıda filtr yoxdur.

İcazə tələb olunur: domains:list

Nümunə Sorğu

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

Nümunə Cavab

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

Cavab Sahələri

_Domen Məlumatlarını Al

Üstdəki sahələr ilə bir domen cismi geri qaytarır.

İcazə tələb olunur: domains:list

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

Cavab Status Kodları

Domenin mövcudluğunu axtar

Adın 20 populyar uzantıda (com, net, org, io, dev, co, app, ai və daha çox) mövcud olub olmadığını yoxlayır, əlavə olaraq daxil etdiyiniz uzantının bu uzantıların arasında olmamasını da. Nəticələr tam uyğunluqla başlayır, sonra mövcud adlar, sonra da istifadə olunanlar.

İcazə tələb olunur: domains:search

Əsas Parametrləri Sorğu

Nümunə Sorğu

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

Nümunə Cavab

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

Qiymətlər bir il üçün dollarla göstərilir və mövcud olmayan adlar üçün null hesab edilir. Göstərilən qiymətlər təsviredicidir.

Cavab Status Kodları

Yeni Domen Qeydiyyatı

Domeni qeyd edir və qeyd etdiyiniz ödəniş üsulunu ödəyir. Üzvlük və qiymət ödənişdən əvvəl qeydçi ilə yenidən yoxlanır. Qeydçi ilə əlaqə məlumatları hesab profilinizdən alınır. Əgər qeydçi ödənişdən sonra qeydi rədd edərsə, ödəniş geri qaytarılır.

İcazə tələb olunur: domains:register (domenlər tərəfindən verilmiş:*)

Əsas Parametrləri Sorğu

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

Nümunə Cavab

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

Cavab Status Kodları

Domeni Yenilə

Domeni yenilə və hər il üçün yeniləmə_qiymətini qeyd etdiyiniz ödəniş üsulu ilə ödə.

İcazə tələb olunur: domains:renew

Əsas Parametrləri Sorğu

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

Cavab Status Kodları

Ad Vericiləri

Domenin ad vericilərini qeydiyyatçıda quraşdırır və yenilənmiş domen cismini geri qaytarır. DNS-i DNS API ilə idarə etmək üçün ns1.vps.org, ns2.vps.org və ns3.vps.org istifadə edin və domen üçün bir zona yaradın.

İcazə tələb olunur: domains:update

Əsas Parametrləri Sorğu

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

Cavab Status Kodları

Avtomatik Yeniləməni Fəal/Qapalı Et

auto_renew qur və yenilənmiş domen cismini geri qaytar. JSON boolean olaraq göndərmək fəallaşdırılmışdır: boş olmayan hər hansı string, string false daxil olmaqla, auto-renew'i işə salır.

İcazə tələb olunur: 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}'

Cavab Status Kodları

Qeydlər

• API domen silmə, domen köçürmə, WHOIS gizliliyi və ya köçürmə qıfılı dəyişdirə bilməz. Göndərmə və silmə admin.vps.org idarə panelində mövcuddur.
• DNS-in bir domen üçün qeydləri DNS API ilə idarə olunur. DNS İdarəetmə API-si