I-API yoLawulo lwe-DNS

Isishwankathelo

I-DNS API ibonelela ngolawulo olupheleleyo lweendawo ze-DNS kunye neerecords. Zonke iindawo zibekwe kwi-VPS.org's iiseva zegama eligunyazisiweyo ngokwenza ngokuzenzekelayo i-BIND9 zone file generation kunye nokubekwa.

Igama leseva

• ns1.vps.org (38.248.6.195) - Umphathi ophambili one-DNSSEC inline-signature
• ns2.vps.org (38.248.6.196) - I-slave yesibini
• ns3.vps.org (38.248.6.197) - I-slave yesibini

Iimpawu eziphambili

• Ukwenziwa kunye nokubekwa ngokuzenzekelayo kweefayili zendawo ye-BIND9
• Iindawo zokudlulisa nge-TSIG yobubhali (ukuphindaphinda komphathi-umkhonzi)
• Inkxaso kuzo zonke iintlobo ezinkulu ze-DNS (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• Igama lethambeka lokucoca ulwelo kunye nochazo lwendawo olusekelwe kwi-UUID
• Iindlela ezifakelweyo zolawulo lwerekhodi ekhethekileyo yendawo

Uqinisekiso

Zonke izicelo ze-DNS API zifuna ubungqina be-Bearer token. Yenza i-API tokens kwi-dashboard ye-akhawunti yakho kwi /account/developers/ ngezimvumelwano ezilandelayo:

• dns:list - Bonisa imimandla ye-DNS kunye neerekhodi
• dns:create - Dala iziqithi ezintsha kunye neerecords
• dns:update - Tshintsha imimandla esele ikhona kunye neerekhodi
• dns:delete - Cima imimandla neengxelo
• dns:* - Ufikelelo olupheleleyo lolawulo lwe-DNS

Umzekelo

Authorization: Bearer vps_abc123def456...

Dwelisa Zonke iiNdawo zeDNS

Fumana uluhlu olushicilelweyo lwazo zonke iindawo ze DNS ezikhoyo kumsebenzisi oqinisekisiweyo. Inkxaso yokucoca ngegama lethambeka.

IiParamitha zoMbuzo

Isicelo somzekelo

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

Impendulo yoMzekelo

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

IiNdawo zeMpendulo

Iikhowudi zeMeko yokuphendula

Fumana Iinkcukacha Zommandla we DNS

Fumana ulwazi oluthe kratya malunga nommandla okhankanyiweyo we DNS, kuquka zonke izingeniso.

Iiparameter zeNdlela

Impendulo yoMzekelo

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

Iikhowudi zeMeko yokuphendula

Yenza i DNS

Yenza indawo entsha ye DNS yethambeka. Indawo izakubekwa ngokuzenzekelayo kumamkeli wegama angama-VPS.org.

Cela iiParamitha zoMzimba

Isicelo somzekelo

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

Impendulo yoMzekelo

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

Iikhowudi zeMeko yokuphendula

Cima i DNS

Cima ngokusisigxina ummandla we DNS kunye nazo zonke iirekhodi ezidityanisiweyo. Esi senzo asikwazi ukubuyiselwa.

Iiparameter zeNdlela

Iikhowudi zeMeko yokuphendula

Uluhlu lweeRekodi ze DNS kwiZiko

Fumana zonke iirekhodi ze DNS zendawo ekhankanyiweyo (umendo obekwe ngokulandelelana).

Iiparameter zeNdlela

Isicelo somzekelo

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

Impendulo yoMzekelo

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

Yenza i DNS Record kwi Zonke

Yongeza i-record entsha ye-DNS kummandla okhankanyiweyo (umendo obekwe ngokulandelelana).

Cela iiParamitha zoMzimba

Isicelo somzekelo

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

Iikhowudi zeMeko yokuphendula

Iifayile ze- DNS

Imisebenzi epheleleyo ye-CRUD kwi-DNS ebhalisiweyo nganye usebenzisa i-UUID yoshicilelo.

Imisebenzi Efumanekayo

• 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

Iiparamitha Zombuzo (ukufumana /api/v1/dns-records/)

Umzekelo: Hlaziya i TTL ye Record

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

Iinkqubo ezilungileyo

Uqwalaselo lwe TTL

• Ukwenza (ozinzileyo): 3600- 86400 imizuzwana (1- 24 iiyure)
• Phambi kokungatshintshi: 300- 600 imizuzwana (5- 10 imizuzwana) - Nciphisa i TTL phambi kotshintsho olucwangcisiweyo
• Uphuhliso: 300-1800 imizuzwana (5-30 imizuzwana) uvavanyo olukhawulezayo

Iipateni Eziqhelekileyo

• Igama lethambeka lengcambu (@): Sebenzisa i-A/AAAA iirekhodi, hayi i-CNAME
• Ithambeka elingaphantsi le www: Isebenzisa i-CNAME ebonisa ingcambu okanye i-A ye-record ehlukileyo
• I-imeyile (MX): Soloko ufaka ukuqala kuqala, inani eliphantsi = ukuqala kuqala okuphezulu
• CNAME: Ayikwazi ukuqhubeka nokusebenza nezinye iintlobo zerekhodi ngegama elifanayo

Ukhuseleko

• Ii-CAA Records: Chaza ukuba zeziphi i-CAs ezikwaziyo ukunikezela ngesiqinisekiso
• SPF/DKIM/DMARC: Qwalasela ubungqina be-imeyili ukuthintela ukudubula
• Iinkqubo zolawulo Khangela iirekhodi ze-DNS ngeveki, susa izingeniso ezingasebenziyo

Imposiso Yophatho

Imposiso eqhelekileyo

Umzekelo Wempendulo Yemposiso

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

Uvavanyo lwe DNS Iinguqu

Qinisekisa Unikezelo Lwerekhodi

# 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

Ukusebenzisa Izixhobo Zonxibelelwano

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