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
• Зона передачи через удостоверение ВСИГ (репродукция в качестве основного раба)
• Поддержка всех основных видов DNS (A, A, CNAME, MX, TXT, NS, SRV, CAA)
• Фильтрация доменных названий и идентификация зоны, основанной на UUID
• Путьи для ведения документации по конкретным зонам

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

Все запросы DNS API требуют аутентификации символа Bearer. Выделите символы API с вашего аккаунта на экране /account/developers/ со следующими разрешениями:

• dns:list - Вид Зоны и записи DNS
• dns:create - Создание новых зон и рекордов
• dns:update - Внести изменения в существующие зоны и регистры
• dns:delete - Удалить зоны и записи
• 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

Найдите подробную информацию о конкретной зоне ДНС, включая все записи.

Параметры пути

Пример ответа

{
  "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 ( " Direct Access " )

Полные операции 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-cords/)

Пример: Обновить 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/A, а не CNAME
• www subdomain: Может использоваться CNAME, указывающий на корневой или отдельный рекорд A
• Электронная почта (MX): Всегда включать приоритет, меньшее число = более высокий приоритет
• Кейт: Невозможно сосуществовать с другими типами для одного и того же имени

Безопасность

• Записи CAA: Указать, какие СС могут выдавать сертификаты
• 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