API за управување со DNS

Преглед

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 tokena. Генерирајте API токени од вашата табла за сметка на /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 записи (директен пристап)

Комплетни операции на CRUD на индивидуалните DNS записи со користење на записот UUID.

Достапни операции

• 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- записи /)

Пример: Ажурирај 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 минути) - Долна TTL пред планираните промени
• Развој: 300-1800 секунди (5-30 минути) за побрзо тестирање

Заеднички обрасци

• Коренен домен (@): Користи A/AAAA записи, не CNAME
• www- subdomain: Може да се користи CNAME кој покажува кон коренот или одвојува запис
• Е- пошта (MX): Секогаш вклучи го приоритетот, понискиот број = повисок приоритет
• ЦИМЕ: Не можам да соработувам со други типови на записи за истото име

Безбедност

• CAA записи: Наведи кои СА можат да издаваат сертификати
• СПФ/ДКИМ/ДМАРК: Конфигурирај ја автентичноста на е- поштата за спречување на спуфирање
• Регуларни ревизии: Преглед на 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