API pro správu DNS

Přehled

DNS API poskytuje plnou správu DNS zón a záznamů. Všechny zóny jsou hostovány na VPS.org autoritativních jmenserverů s automatickou BIND9 zónou tvorby souborů a nasazení.

Infrastruktura nameserveru

• ns1.vps.org (38.248.6.195) - Primární master s DNSSEC inline-signing
• ns2.vps.org (38.248.6.196) - Sekundární otrok
• ns3.vps.org (38.248.6.197) - Sekundární otrok

Klíčové funkce

• Automatická tvorba a nasazení souborů v zóně BIND9
• Zónové přenosy prostřednictvím TSIG autentizace (master-slave replikation)
• Podpora pro všechny hlavní typy DNS záznamů (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• Filtrování názvu domény a identifikace zóny na bázi UUID
• Vyhrazené trasy pro správu záznamů specifických pro danou zónu

Ověřování

Všechny DNS API požadavky vyžadují Bearer žeton autentizace. Generovat API žetony z vašeho účtu palubní desku na /account/developers/ s těmito povoleními:

• dns:list - Zobrazit zóny a záznamy DNS
• dns:create - Vytvořit nové zóny a záznamy
• dns:update - Upravit stávající zóny a záznamy
• dns:delete - Smazat zóny a záznamy
• dns:* - Kompletní přístup k řízení DNS

Příklad

Authorization: Bearer vps_abc123def456...

Zobrazit všechny DNS zóny

Získejte seznam všech zón DNS vlastněných ověřeným uživatelem. Podporuje filtrování podle jména domény.

Parametry dotazu

Příklad žádosti

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

Příklad odpovědi

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

Pole odpovědí

Kódy stavu odpovědi

Získejte detaily DNS zóny

Získejte podrobné informace o konkrétní zóně DNS, včetně všech záznamů.

Parametry cesty

Příklad odpovědi

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

Kódy stavu odpovědi

Vytvořit zónu DNS

Vytvořte novou DNS zónu pro doménu. Zóna bude okamžitě nasazena na VPS.org jmenných serverů.

Parametry těla požadavku

Příklad žádosti

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

Příklad odpovědi

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

Kódy stavu odpovědi

Smazat oblast DNS

Trvale smažte zónu DNS a všechny související záznamy. Tato akce nemůže být zrušena.

Parametry cesty

Kódy stavu odpovědi

Seznam DNS záznamů v zóně

Získejte všechny záznamy DNS pro určitou zónu (vyčištěnou trasu).

Parametry cesty

Příklad žádosti

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

Příklad odpovědi

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

Vytvořit DNS záznam v zóně

Přidat nový DNS záznam do určité zóny (vyčištěná trasa).

Parametry těla požadavku

Příklad žádosti

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

Kódy stavu odpovědi

Správa DNS záznamů (Direct Access)

Plné CRUD operace na jednotlivých DNS záznamů pomocí záznamu UUID.

Dostupné operace

• 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

Parametry dotazu (pro GET /api/v1/dns-records/)

Příklad: Aktualizovat TTL záznamu

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

Nejlepší praxe

TTL konfigurace

• Výroba (stabilní): 3600-86400 sekund (1-24 hodin)
• Před migrací: 300-600 sekund (5-10 minut) - Dolní TTL před plánovanými změnami
• Vývoj: 300-1800 sekund (5-30 minut) pro rychlejší testování

Vzory

• Root domain (@): Použít záznamy A/AAAA, nikoli CNAME
• www subdoména: Může použít CNAME ukazování na kořen nebo oddělit záznam
• E-mail (MX): Vždy patří priorita, nižší počet = vyšší priorita
• CNAME: Nelze koexistovat s jinými typy záznamů pro stejný název

Bezpečnost

• CAA Records: Uveďte, které CA mohou vydávat certifikáty
• SPF/DKIM/DMARC: Nastavit autentizaci e-mailu, aby se zabránilo spoofing
• Pravidelné audity: Zkontrolovat záznamy DNS čtvrtletně, odstranit nepoužité položky

Chyba při manipulaci

Časté chyby

Příklad Chybová odpověď

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

Testování změn DNS

Ověřit šíření záznamů

# 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

Používání online nástrojů

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