DNS stjórnun API

Yfirlit

DNS API veitir fulla stjórn á DNS svæðum og skrám.Öll svæði eru hýst á VPS.org's opinberum nafnþjónum með sjálfvirkri BIND9 svæðisskrá og dreifingu.

Nafnþjónn

• ns1.vps.org (38.248.6.195) - Aðalmeistari með DNSSEC í línu- undirskrift
• ns2.vps.org (38.248.6.196) - Aukaþræll
• ns3.vps.org (38.248.6.197) - Aukaþræll

Lykilatriði

• Sjálfvirk BIND9 svæði skrá kynslóð og dreifing
• Svæðisflutningar með TSIG auðkenningu (meistari-þræll afritun)
• Stuðningur við allar helstu DNS skráartegundir (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• Lén nafn síun og UUID-undirstaða svæði auðkenning
• Nested leiðir fyrir svæðisbundna skrá stjórnun

Auðkenning

Búðu til API tákn frá reikningnum þínum á mælaborðinu á /account/developers/ Með eftirfarandi heimildir:

• dns:list - Skoða DNS svæði og skrár
• dns:create - Búa til ný svæði og skrár
• dns:update - Breyta núverandi svæðum og skrám
• dns:delete - Eyða svæðum og skrám
• dns:* - Fullur DNS stjórnun aðgangur

Dæmi

Authorization: Bearer vps_abc123def456...

Listi yfir öll DNS svæði

Sækja síðulista yfir öll DNS svæði sem eru í eigu auðkennds notanda. Styður síun eftir lénsheiti.

Fyrirspurnarbreytur

Dæmi um beiðni

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

Dæmi um svar

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

Svarsvið

Kóðar fyrir svörunarstöðu

Fá DNS Zone Upplýsingar

Sækja nákvæmar upplýsingar um tiltekna DNS svæði, þar á meðal allar færslur.

Slóðarbreytur

Dæmi um svar

{
  "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óðar fyrir svörunarstöðu

Búa til DNS svæði

Búa til nýtt DNS svæði fyrir lén. Svæðið verður strax dreift á VPS.org nafnþjóna.

Færibreytur beiðninnar

Dæmi um beiðni

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

Dæmi um svar

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

Kóðar fyrir svörunarstöðu

Eyða DNS svæði

Eyða varanlega DNS svæði og öllum tengdum færslum. Ekki er hægt að afturkalla þessa aðgerð.

Slóðarbreytur

Kóðar fyrir svörunarstöðu

Listi yfir DNS færslur í Zone

Sækja allar DNS færslur fyrir tiltekið svæði (nested leið).

Slóðarbreytur

Dæmi um beiðni

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

Dæmi um svar

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

Búa til DNS færslu í Zone

Bæta við nýjum DNS færslu til tiltekins svæðis (nested leið).

Færibreytur beiðninnar

Dæmi um beiðni

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óðar fyrir svörunarstöðu

Stjórna DNS skrám (beinn aðgangur)

Full CRUD aðgerðir á einstökum DNS skrám með því að nota skrá UUID.

Tiltækar aðgerðir

• 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

Fyrirspurn breytur (fyrir GET /api/v1/dns-skrár/)

Dæmi: Uppfæra TTL skráar

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

Bestu starfsvenjur

TTL stillingar

• Framleiðsla (stöðugt): 3600-86400 sekúndur (1-24 klukkustundir)
• Fyrir flutning: 300-600 sekúndur (5-10 mínútur) - Lægri TTL fyrir fyrirhugaðar breytingar
• Þróun: 300-1800 sekúndur (5-30 mínútur) fyrir hraðari prófanir

Algeng mynstur

• Rótarlén (@): Nota A/AAAA færslur, ekki CNAME
• www undirlén: Getur notað CNAME sem bendir til rótar eða aðskilin A skrá
• Netfang (MX): Alltaf forgang, lægri tala = hærri forgangur
• CNAME: Ekki má sameinast öðrum skráartegundum fyrir sama nafn

Öryggi

• CAA Records: Tilgreina hvaða CAs geta gefið út skírteini
• SPF/ DKIM/ DMARC: Stilla auðkenningu tölvupósts til að koma í veg fyrir svik
• Reglulegar endurskoðanir: Endurskoða DNS skrár ársfjórðungslega, fjarlægja ónotaðar færslur

Villuumsjón

Algengar villur

Dæmi um villusvörun

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

Prófa DNS breytingar

Staðfesta fjölgun skráa

# 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

Notkun á netinu verkfæri

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