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 Records (директен достъп)

Пълни операции 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: Може да използвате CNAME, насочен към корен или отделен запис A
• Е- поща (MX): Винаги включват приоритет, по-нисък брой = по-висок приоритет
• КАЗВА: Не може да съществува съвместно с други типове записи за едно и също име

Безопасност

• КАА записи: Уточнете кои 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