DNS İdarəetmə API-si

Baxış

DNS API DNS zonaları və qeydləri tam idarə edir. Bütün zonalar VPS.org-in etibarlı ad vericilərində avtomat BIND9 zona faylının yaradılması və işə salınması ilə yerləşir.

Ad Vericiləri

• ns1.vps.org (38.248.6.195) - DNSSEC daxili imza ilə əsas master
• ns2.vps.org (38.248.6.196) - İkinci Slave
• ns3.vps.org (38.248.6.197) - İkinci Slave

Xüsusiyyətlər

• Avtomatik BIND9 zona faylının yaradılması və işə salınması
• TSIG tanınması vasitəsilə zona köçürmələri (master-slave təkrarlanması)
• Bütün əsas DNS qeyd növləri üçün dəstək (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• Domen adı filtrləməsi və UUID-ə əsaslanan zona identifikasiyası
• Bölgə-xüsusi qeyd idarəsi üçün bünövrələnmiş yolları

Doğrulama

Bütün DNS API tələbləri Bearer token tanınması tələb edir. Hesabınızdakı dashboard-dan API tokenləri buraya göndərin /account/developers/ Aşağıdakı icazələrlə:

• dns:list - DNS zonaları və qeydləri göstər
• dns:create - Yeni zonalar və qeydlər yarat
• dns:update - Hazırkı zonaları və qeydləri dəyişdir
• dns:delete - Bölgələr və qeydləri sil
• dns:* - DNS idarəçiliyi

Məsələ

Authorization: Bearer vps_abc123def456...

Bütün DNS Zonalarını Siyahıya Alın

Tanınan istifadəçiyə aid bütün DNS zonalarının səhifələnmiş siyahısını əldə et. Domen adı ilə filtrləməni dəstəkləyir.

Sorğu Parametrləri

Nümunə Sorğu

curl -X GET "https://admin.vps.org/api/v1/dns-zones/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

url = "https://admin.vps.org/api/v1/dns-zones/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/dns-zones/', {
  headers: {'Authorization': 'Bearer YOUR_API_TOKEN'}
});

const zones = await response.json();
console.log(zones);

Nümunə Cavab

[
  {
    "uuid": "abc123-def456-ghi789",
    "domain": "example.com",
    "created_at": "2024-01-15T10:30:00Z",
    "record_count": 12
  },
  {
    "uuid": "xyz789-uvw456-rst123",
    "domain": "myapp.io",
    "created_at": "2024-06-20T14:15:00Z",
    "record_count": 8
  }
]

Cavab Sahələri

Cavab Status Kodları

DNS Bölgəsi Məlumatlarını Al

Bütün qeydlər daxil olmaqla müəyyən bir DNS zonası haqqında ətraflı məlumat əldə et.

Yol Parametrləri

Nümunə Cavab

{
  "uuid": "abc123-def456-ghi789",
  "domain": "example.com",
  "created_at": "2024-01-15T10:30:00Z",
  "record_count": 5,
  "records": [
    {
      "uuid": "rec-001",
      "record_type": "A",
      "name": "@",
      "value": "192.0.2.1",
      "ttl": 3600,
      "priority": null,
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "uuid": "rec-002",
      "record_type": "MX",
      "name": "@",
      "value": "mail.example.com",
      "ttl": 3600,
      "priority": 10,
      "created_at": "2024-01-15T10:32:00Z"
    }
  ]
}

Cavab Status Kodları

DNS Zonası Yarat

Bir domen üçün yeni bir DNS zonası yaradın. Zona dərhal VPS.org ad vericisinə işə salınır.

Əsas Parametrləri Sorğu

Nümunə Sorğu

curl -X POST "https://admin.vps.org/api/v1/dns-zones/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "newdomain.com"}'

import requests

url = "https://admin.vps.org/api/v1/dns-zones/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {"domain": "newdomain.com"}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/dns-zones/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({domain: 'newdomain.com'})
});

const zone = await response.json();
console.log(zone);

Nümunə Cavab

{
  "uuid": "new-zone-uuid",
  "domain": "newdomain.com",
  "created_at": "2026-01-18T16:45:00Z",
  "record_count": 0,
  "records": []
}

Cavab Status Kodları

DNS Zonasını Sil

DNS zonasını və bütün əlaqəli qeydləri daimi olaraq sil. Bu əməliyyat geri alına bilməz.

Yol Parametrləri

Cavab Status Kodları

DNS qeydlərini zonada göstər

Xüsusi bir zona üçün bütün DNS qeydlərini (gövdələşmiş marşrut) əldə et.

Yol Parametrləri

Nümunə Sorğu

curl -X GET "https://admin.vps.org/api/v1/dns-zones/{uuid}/records/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Nümunə Cavab

[
  {
    "uuid": "rec-001",
    "record_type": "A",
    "name": "@",
    "value": "192.0.2.1",
    "ttl": 3600,
    "priority": null,
    "created_at": "2024-01-15T10:30:00Z"
  },
  {
    "uuid": "rec-002",
    "record_type": "MX",
    "name": "@",
    "value": "mail.example.com",
    "ttl": 3600,
    "priority": 10,
    "created_at": "2024-01-15T10:32:00Z"
  }
]

DNS Qeydini Yarat

Xüsusi bir zonaya yeni bir DNS qeydi əlavə et (gövdələşmiş marşrut).

Əsas Parametrləri Sorğu

Nümunə Sorğu

curl -X POST "https://admin.vps.org/api/v1/dns-zones/{uuid}/records/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "record_type": "A",
    "name": "www",
    "value": "192.0.2.1",
    "ttl": 3600
  }'

import requests

url = f"https://admin.vps.org/api/v1/dns-zones/{zone_uuid}/records/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "record_type": "A",
    "name": "www",
    "value": "192.0.2.1",
    "ttl": 3600
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Cavab Status Kodları

DNS qeydlərini idarə et (düzgün çıxış)

UUID qeydi istifadə edərək fərdi DNS qeydləri üzərində tam CRUD əməliyyatları.

Mövcud əməliyyatlar

• GET /api/v1/dns-records/{uuid}/ - Retrieve record details
• PUT /api/v1/dns-records/{uuid}/ - Full update (all fields required)
• PATCH /api/v1/dns-records/{uuid}/ - Partial update (only changed fields)
• DELETE /api/v1/dns-records/{uuid}/ - Delete record

Sorğu Parametrləri (GET /api/v1/dns-records/ üçün)

Məsələn: TTL-ni yenilə

curl -X PATCH "https://admin.vps.org/api/v1/dns-records/{rec-uuid}/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ttl": 1800}'

Supported DNS Record Types

Ən Yaxşı Əməliyyatlar

TTL Quraşdırması

• İstehsal (dəqiq): 3600-86400 saniyə (1-24 saat)
• _Gəzdirmə: 300-600 saniyə (5-10 dəqiqə) - Planlaşdırılan dəyişikliklərdən əvvəl TTL'yi aşağı sal
• İnkişaf 300-1800 saniyə (5-30 dəqiqə) sürətli test üçün

Əlaqələndir

• Kök domen (@): CNAME deyil, A/AAAA qeydlərini işlət
• www alt domeni: CNAME kökə və ya ayrı A qeydinə işarə edə bilər
• E-poçt (MX): Həmişə prioriteti daxil et, aşağı nömrə = yüksək prioritet
• _Ad: Aynı ad üçün digər qeyd növləri ilə birgə mövcud ola bilməz

Təhlükəsizlik

• CAA Records: Vəsiqəni çıxara bilən CA-ları göstər
• SPF/DKIM/DMARC: E-poçt təsdiqini saxtalaşdırmamaq üçün qur
• Əsas DNS qeydlərini ayda bir yoxla, istifadə edilməmiş daxilolmaları sil

Xəta İdarəetmə

Ən çox rast gəlinən xətalar

Xəta cavabı nümunəsi

{
  "detail": "MX records require a priority value",
  "error_code": "validation_error",
  "field": "priority"
}

DNS dəyişiklikləri sınanır

Qeyd Yayılmasını Yoxla

# Query A record
dig example.com A

# Query specific nameserver
dig @ns1.vps.org example.com

# Query MX records
dig example.com MX

# Check all records
dig example.com ANY

İnternet vasitələri

• whatsmydns.net: Check global DNS propagation
• dnschecker.org: Multi-location DNS lookup
• mxtoolbox.com: Email-related DNS testing