DNS башкаруу API'си

Жалпы маалымат

DNS API DNS зоналарын жана жазууларды толук башкарууну камсыз кылат. Бардык зоналар VPS.org авторитеттүү ысым серверлеринде автоматтык BIND9 зона файлдарын генерациялоо жана жайгаштыруу менен жайгаштырылат.

Сервердин аты

• ns1.vps.org (38.248.6.195) - DNSSEC-инлайн кол коюу менен негизги ээси
• ns2.vps.org (38.248.6.196) - Экстра
• ns3.vps.org (38.248.6.197) - Экстра

Ачкыч өзгөчөлүктөрү

• Автоматтык BIND9 зона файлдарын түзүү жана жайгаштыруу
• Зоналык трансферлер TSIG аутентификациясы аркылуу (мастер-слев репликациясы)
• Бардык негизги DNS жазуу түрлөрүн колдоо (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• Домендин аттарын фильтрлөө жана UUIDге негизделген зона идентификациясы
• Зонага таандык жазууларды башкаруу үчүн жайгашкан жолдор

Аутентификация

Бардык DNS API суроолору үчүн Bearer token аутентификациясы керек. API tokens from your account dashboard at /account/developers/ төмөнкү уруксат менен:

• dns:list - DNS зоналары жана жазууларын көрүү
• dns:create - Жаңы зоналарды жана жазууларды жаратуу
• dns:update - Бар болгон зоналарды жана жазууларды өзгөртүү
• dns:delete - Зоналарды жана жазууларды өчүрүү
• dns:* - DNS башкаруусуна толук укуктар

Мисал

Authorization: Bearer vps_abc123def456...

Бардык DNS зоналарынын тизмеси

Аутентификацияланган колдонуучунун ээлик кылган бардык DNS зоналарынын тизмесин алуу. Домендин аты боюнча фильтрлөө колдойт.

Сурам параметрлери

Үлгү суроо-талап

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

Мисал жооп

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

Жооп талаалары

Жооп берүү статусунун коддору

DNS зонасынын деталдарын алуу

Белгиленген DNS зонасы жөнүндө толук маалыматты алуу, анын ичинде бардык жазууларды.

Жол параметрлери

Мисал жооп

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

Жооп берүү статусунун коддору

DNS зонасын жаратуу

Домен үчүн жаңы DNS зонасын жаратуу. Зона дароо эле VPS.org ысым серверине жайгаштырылат.

Сурамдын негизги параметрлери

Үлгү суроо-талап

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

Мисал жооп

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

Жооп берүү статусунун коддору

DNS зонасын өчүрүү

DNS-зонаны жана ага тиешелүү бардык жазууларды калыбына келтирүү. Бул өнөктүктү жокко чыгаруу мүмкүн эмес.

Жол параметрлери

Жооп берүү статусунун коддору

Зонада DNS жазууларынын тизмесин көрсөтүү

Белгиленген зона үчүн бардык DNS жазууларын алуу (интеграцияланган маршрут).

Жол параметрлери

Үлгү суроо-талап

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

Мисал жооп

[
  {
    "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 жазуусун жаратуу

Жаңы DNS жазуусун аныкталган зонага (интеграцияланган маршрутка) кошуу.

Сурамдын негизги параметрлери

Үлгү суроо-талап

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

Жооп берүү статусунун коддору

DNS жазууларын башкаруу (түз кирүү)

UUID жазуусун колдонуу менен жеке DNS жазууларына толук CRUD операциялары.

Бар операциялар

• 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

Запрос параметрлери (GET /api/v1/dns-records/ үчүн)

Мисал: жазуунун TTL-ин жаңылоо

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

Эң мыкты практика

TTL конфигурациясы

• Продукция (стабилдүү): 3600-86400 секунд (1-24 саат)
• Миграциядан мурун: 300-600 секунд (5-10 мүнөт) - ТТЛди пландалган өзгөрүүлөрдөн мурун төмөндөтүү
• Иштетүү: 300-1800 секунд (5-30 мүнөт) тез текшерүү үчүн

Жалпы үлгүлөр

• Ортолук домен (@): A/AAAA жазууларын колдонуу, CNAME эмес
• www субдомени: CNAME көрсөткүчүн тамырга же бөлөк A жазуусуна колдонууга болот
• Эл. почта (MX): Ар дайым приоритетти камтуу, төмөнкү сан = жогорку приоритет
• CNAME: Бирдей аттагы башка жазуу түрлөрү менен бирдей болушу мүмкүн эмес

Коопсуздук

• CAA жазуулары: Сертификаттарды чыгарууга уруксат берген CAларды көрсөтүңүз
• SPF/DKIM/DMARC: Эл. почтанын аутентификациясын орнотуу
• Регулярдык аудиттер: DNS жазууларын квартал сайын текшерүү, колдонулбаган жазууларды өчүрүү

Каталарды иштетүү

Көбүнчө кездешүүчү каталар

Ката жооп мисалы

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

DNS өзгөрүүлөрүн текшерүү

Запись распространения проверить

# 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

Интернет аспаптарын колдонуу

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