API Whakahaere DNS

Tirohanga Whānui

Ka whakarato te DNS API i te whakahaeretanga katoa o nga rohe me nga pūkete DNS. Ka whakanohotia ngā rohe katoa ki runga i ngā pūnaha ingoa mana o te VPS.org me te whakanao me te whakataunga tāuru o te rohe BIND9.

Ka taea te whakataki i te pūnaha pūnaha

• ns1.vps.org (38.248.6.195) - Mātauranga matua me te whakaingoatanga-whāiti DNSSEC
• ns2.vps.org (38.248.6.196) - Tuarua
• ns3.vps.org (38.248.6.197) - Tuarua

Āhuatanga kī

• Ko te whakatūnga me te whakawhānui i ngā pūranga rohe BIND9
• Ka whakawhitia te rohe mā te manatoko TSIG (whakarua matua-kaimahi)
• Mā te tautoko i ngā momo pūkete DNS matua katoa (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• Tītaki ingoa rohe me te tohu rohe i runga i te UUID
• He ara whakatata mo te whakahaeretanga pūkete ā-rohe

Whakamotuhēhēnga

E hiahiatia ana e ngā tono API DNS katoa te manatoko tohu Taketake. Whakanao i ngā tohu API mai i tō tātou papatono kāwanatanga ā-kōrero i te /account/developers/ me ēnei whakaaetanga:

• dns:list - Ka tirohia ngā rohe DNS me ngā pūkete
• dns:create - Ka waihanga i ngā rohe me ngā pūkete hōu
• dns:update - Ka whakarerekē i ngā rohe me ngā pūkete tīariari
• dns:delete - Ka tangohia ngā rohe me ngā pūkete
• dns:* - Ka taea te whakahaere mana DNS katoa

Hei tauira

Authorization: Bearer vps_abc123def456...

Rārangihia ngā Rohe DNS Katoa

Ka whiwhi rātau i tētahi rārangi pāpāho o ngā rohe DNS katoa e noho ana ki te kaimahi whakatūturu. E tautoko ana i te tātaritanga e te ingoa rohe.

Ngā Tawhā Uiui

Tauira Tono

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

Tauira Whakautu

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

Ngā Āpure Whakautu

Ngā Waehere Tūnga Urupare

Ki te whiwhi mōhiohio rohe DNS

Ka whiwhi mōhiohio mārama mō tētahi rohe DNS tauwhāiti, tae atu ki ngā pūkete katoa.

Ngā Tawhā Ara

Tauira Whakautu

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

Ngā Waehere Tūnga Urupare

Ka waihanga tētahi rohe DNS

Ka waihanga tētahi rohe DNS hou mō tētahi rohe. Ka whakawāteatia te rohe kia VPS.org ngā pūnaha ingoa.

Tonohia ngā Tawhā Tinana

Tauira Tono

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

Tauira Whakautu

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

Ngā Waehere Tūnga Urupare

Ka tangohia te rohe DNS

Ka tango tūturu tētahi rohe DNS me ngā pūkete pāhono katoa. Kāore e taea te whakakore i tēnei mahi.

Ngā Tawhā Ara

Ngā Waehere Tūnga Urupare

Tatauranga o ngā pūkete DNS i roto i te rohe

Ka whiwhi ngā pūkete DNS katoa mō tētahi rohe tauwhāiti (ngā ara whakatata).

Ngā Tawhā Ara

Tauira Tono

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

Tauira Whakautu

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

Ka waihanga tētahi pūkete DNS i roto i te rohe

Ka tāpiri i tētahi pūkete DNS hou ki tētahi rohe tauwhāiti (ngā ara whakatata).

Tonohia ngā Tawhā Tinana

Tauira Tono

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

Ngā Waehere Tūnga Urupare

Manawa ngā pūkete DNS (Tiaki hāngai)

Ko ngā mahi CRUD katoa i runga i ngā pūkete DNS takitahi mā te whakamahi i te pūkete UUID.

He mahi wātea

• 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

Parameter (nā te GET /api/v1/dns-records/)

Hei tauira: Whakahou i te TTL o tētahi pūkete

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

Ko nga mahi pai rawa

Whakarekētanga

• Whakanaotanga (tau tōpū): 3600-86400 waeine (1-24 wā)
• I mua i te heke: 300-600 ngā taki (5-10 ngā minu) - TTL iti ake i mua i ngā huringa i whakaritea
• Whakawhanaketanga: 300-1800 ngā takiwā (5-30 ngā minu) mō te whakamātautau tere ake

Kāhua noa iho

• Whare Wāhi (@): Ka whakamahia ngā pūkete A/AAAA, ehara i te CNAME
• WWW rohe-roto: Ka taea te whakamahi i te tohu CNAME ki te pūtake, ki te whakawātea rānei i tētahi pūkete A
• Mai (MX): Kei roto i ngā wā katoa te arotahi, te tau iti iho = arotahi tiketike ake
• CNAME: Kāore e taea te hono ki ētahi atu momo pūkete mō te ingoa ōrite

Haumarutanga

• Ko ngā pūkete CAA: Ka whakapūtātia he aha ngā CA ka taea te tuku i ngā tohu
• SPF/DKIM/DMARC: Ka whakaritea te manatoko maimona hei ārai i te whakawāteatanga
• Ka whakamātauria ngā tātaritanga pūnoa: Ka arotakea ngā pūkete DNS i ia rau, ka tangohia ngā tāurunga kāore i te whakamahia

Ka whakamātautia te hapa

He hapa noa iho

Hei tauira, he whakautu hapa

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

Ka whakamātautau ngā huringa DNS

Whakamātautau i te whakawhānuitanga o te pūkete

# 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

Mā te whakamahi i ngā utauta paetata

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