API za upravljanje DNS-a

Pregled

DNS API zagotavlja polno upravljanje DNS con in zapisov. Vsa območja so gostitelji na VPS.org avtomatičnih imenskih strežnikih z avtomatskim izdelavo in uvajanjem datotek BIND9 cone.

Infrastruktura imenskega strežnika

• ns1.vps.org (38.248.6.195) - Primarni poveljnik z DNSSEC inline-signing
• ns2.vps.org (38.248.6.196) - Sekundarni suženj
• ns3.vps.org (38.248.6.197) - Sekundarni suženj

Ključne lastnosti

• Samodejno ustvarjanje in uvajanje datotek na območju BIND9
• Prenos cone prek avtentifikacije TSIG (replikacija glavnega sužnja)
• Podpora vsem večjim tipom DNS zapisov (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• Filtriranje domen in identifikacija območja, ki temelji na UUID
• Gnezdne poti za upravljanje rekordov za posamezno območje

Avtentikacija

Vsi zahtevki DNS API zahtevajo prepoznavnost bearerjevega tokena. Ustvarite API žetone iz vaše plošče s računa na /account/developers/ z naslednjimi dovoljenji:

• dns:list - Oglejte si DNS območja in zapise
• dns:create - Ustvari nova območja in zapise
• dns:update - Spremeni obstoječa območja in zapise
• dns:delete - Zbriši območja in zapise
• dns:* - Celoten dostop za upravljanje DNS

Primer

Authorization: Bearer vps_abc123def456...

Seznam vseh DNS con

Pridobite paginiran seznam vseh območij DNS, ki so v lasti avtentikiranega uporabnika. Podpira filtriranje po imenu domene.

Parametri poizvedbe

Primer zahteve

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

Primer odgovora

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

Polja za odgovor

Kode stanja odgovora

Poišči podrobnosti DNS cone

Pridobi podrobne informacije o določenem območju DNS, vključno z vsemi zapisi.

Parametri poti

Primer odgovora

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

Kode stanja odgovora

Ustvari DNS cono

Ustvari novo območje DNS za domeno. Območje bo takoj razporejeno na VPS.org imenskih strežnikov.

Zahtevajte parametre telesa

Primer zahteve

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

Primer odgovora

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

Kode stanja odgovora

Zbriši DNS cono

Trajno izbriši cono DNS in vse povezane zapise. To dejanje ni mogoče razveljaviti.

Parametri poti

Kode stanja odgovora

Seznam DNS zapisov v coni

Pridobi vse zapise DNS za določeno območje (navedena pot).

Parametri poti

Primer zahteve

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

Primer odgovora

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

Ustvari DNS zapis v coni

Dodaj nov zapis DNS v določeno območje (navedena pot).

Zahtevajte parametre telesa

Primer zahteve

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

Kode stanja odgovora

Upravljajte DNS Records (Direct Access)

Celotna operacija CRUD na posamičnih DNS zapisih z uporabo zapisa UUID.

Razpoložljive operacije

• 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

Parametri poizvedbe (za zapise GET /api/v1/dns /)

Primer: Posodobi TTL zapisa

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

Najboljše prakse

Nastavitve TTL

• Proizvodnja (stabila): 3600–86400 sekund (1–24 ur)
• Pred migracijo: 300-600 sekund (5-10 minut) - Nizko TTL pred načrtovanimi spremembami
• Razvoj: 300–1800 sekund (5–30 minut) za hitrejše testiranje

Pogosti vzorci

• Korenita domena (@): Uporabi A/AAAA zapise, ne CNAME
• www subdomain: Lahko uporabite CNAME, ki kaže na koren ali ločen zapis A
• E- pošta (MX): Vedno vključi prednost, nižje število = višja prednostna naloga
• CNAME: Ni moč sodelovati z drugimi tipi zapisov za isto ime

Varnost

• Zapisi CAA: Navedite, kateri CA lahko izdajo potrdila
• SPF/DKIM/DMARC: Nastavite avtentifikacijo e- pošte, da preprečite spoofing
• Redne revizije: Pregled DNS zapisov četrtletno, odstranite neuporabljene vnose

Obvladovanje napak

Pogosti napaki

Primer odziva na napako

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

Preizkušanje sprememb DNS

Preveri povečanje zapisa

# 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

Uporaba spletnih orodij

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