Alan adı API

Tüm Alan Adlarını Listele

Hesabınıza kayıtlı alan adlarını, sayfa başına 25 olarak geri döndürür. Listede filtre yoktur.

İzin gerekiyor: domains:list

Örnek Talep

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

Örnek Yanıt

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

Yanıt Alanları

Alan Adı Ayrıntılarını Al

Yukarıdaki alanlarla bir alan nesnesi geri döndürür.

İzin gerekiyor: domains:list

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

Yanıt Durum Kodları

Alan Adı Ulaşılabilirliğini Ara

Bir ad, yaklaşık 20 popüler uzantıda (com, net, org, io, dev, co, app, ai ve daha fazlası) mevcut olup olmadığını kontrol eder, ayrıca aralarında bulunmadığı takdirde yazdığınız uzantıyı da. Sonuçlar tam eşleşenlerle başlar, sonra mevcut isimler, sonra kullanılanlar.

İzin gerekiyor: domains:search

İstek Gövdesi Parametreleri

Örnek Talep

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

Örnek Yanıt

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

Fiyatlar bir yıl için USD cinsinden rakamlardır ve mevcut olmayan isimler için sıfırdır. Gösterilen fiyatlar örnek olarak kullanılır.

Yanıt Durum Kodları

Yeni Alan Adı Kaydet

Bir alan adı kayıt eder ve kaydedilmiş ödeme yönteminizi tahsil eder. Ulaşılabilirlik ve fiyat, tahsilden hemen önce kayıt şirketiyle tekrar kontrol edilir. Kayıt sahibinin iletişim bilgileri hesabınızdan alınır. Eğer kayıt şirketi tahsilden sonra kayıt işlemini reddediyorsa, ödeme geri ödenir.

İzin gerekiyor: domains:register (alanı tarafından verilen: *)

İstek Gövdesi Parametreleri

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

Örnek Yanıt

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

Yanıt Durum Kodları

Alan Adı Yenile

Alan adını yeniler ve her yıl için yenileme_fiyatı'nı kaydettiğiniz ödeme yöntemine yükler.

İzin gerekiyor: domains:renew

İstek Gövdesi Parametreleri

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

Yanıt Durum Kodları

Ad Sunucularını Güncelle

Alan adı sunucularını kayıtcıya ayarlar ve güncellenmiş alan adı nesnesi geri verir. DNS API ile DNS'yi yönetmek için, ns1.vps.org, ns2.vps.org ve ns3.vps.org kullanın ve alan için bir bölge oluşturun.

İzin gerekiyor: domains:update

İstek Gövdesi Parametreleri

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

Yanıt Durum Kodları

Otomatik Yenileme'yi Etkinleştir veya Kapat

auto_renew'i ayarlar ve güncellenmiş alan nesnesi geri verir. JSON boolean olarak gönderme etkinleştirildi: boş olmayan herhangi bir dizi, false dizisi dahil, otomatik yenilemeyi etkinleştirir.

İzin gerekiyor: 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}'

Yanıt Durum Kodları

Notlar

• API bir alan adını silme, bir alan adını transfer etme, WHOIS gizliliğini değiştirme veya transfer kilidini değiştirme yeteneğine sahip değildir. Transferler ve silmeler admin.vps.org adresindeki kontrol panelinde mevcuttur.
• Bir alan için DNS kayıtları DNS API ile yönetilir. DNS Yönetim API'si