API Pulega DNS

Aotelega

O le DNS API e tuuina atu le puleaina atoa o itulagi ma tusi faamaumauga DNS. O itulagi uma e teuina i le VPS.org's igoa 'au'aunaga ma otometi BIND9 itulagi faila tupulaga ma le faalauiloaina.

Nameserver Infrastructure

• ns1.vps.org (38.248.6.195) - Faʻavae matua ma le DNSSEC inline-signature
• ns2.vps.org (38.248.6.196) - Faʻatolu
• ns3.vps.org (38.248.6.197) - Faʻatolu

Faʻamatalaga autu

• Faʻatupulaia ma faʻaaogaina otometi o faila o le itulagi BIND9
• Faʻaliliuina o le itulagi i le faʻamaonia o le TSIG (faʻataʻitaʻiga o le pule-faʻaipoipo)
• Tuʻuina atu mo uma ituaiga o faʻamaumauga DNS (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• Suʻesuʻega o igoa o le 'au'aunaga ma le faʻailoaina o le itulagi e faʻavae i luga o le UUID
• Nested routes mo le faʻatonu o faʻamaumauga faʻapitoa i le itulagi

Fa'amaoniga

O uma talosaga a le DNS API e manaʻomia ai le faʻamaonia o le Bearer token. /account/developers/ ma nei aia tatau:

• dns:list - Vaʻai i nofoaga ma faʻamaumauga DNS
• dns:create - Faʻatonu
• dns:update - Faʻasaʻo itu ma faʻamaumauga ua iai nei
• dns:delete - Suʻe nofoaga ma faʻamaumauga
• dns:* - Faʻatino le faʻagaioiga o le DNS

Faʻataʻitaʻiga

Authorization: Bearer vps_abc123def456...

Lisi Sone DNS Uma

Faʻatumu se lisi o vaega uma o DNS e pulea e le tagata faʻaoga ua faʻamaonia. E lagolagoina le siakiina e igoa o le itulagi.

Fa'asologa o Fesili

Talosaga Fa'ata'ita'i

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

Tali Fa'ata'ita'i

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

Fanua Tali

Fa'ailoga o Tulaga o Tali

Faʻataga Faʻamatalaga o le Nofoaga DNS

Toe maua faʻamatalaga faʻasolosolo e uiga i se itulagi DNS faapitoa, e aofia ai ma uma faʻamaumauga.

Fa'asologa o Ala

Tali Fa'ata'ita'i

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

Fa'ailoga o Tulaga o Tali

Faʻatonu le DNS

Faʻatulaga se itulagi DNS fou mo se itulagi. O le itulagi o le a faʻaulufaleina i le VPS.org 'au'aunaga igoa.

Talosaga mo Fa'atulagaga o le Tino

Talosaga Fa'ata'ita'i

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

Tali Fa'ata'ita'i

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

Fa'ailoga o Tulaga o Tali

Suʻe

Faʻasolosolo le faʻaigoaina o se 'upega tafaʻilagi. E le mafai ona toe faia lenei gaioiga.

Fa'asologa o Ala

Fa'ailoga o Tulaga o Tali

Faʻavasega faʻamaumauga DNS i le itulagi

Toe maua uma faʻamaumauga DNS mo se itu faapitoa (malae vaʻalele faʻaputuga).

Fa'asologa o Ala

Talosaga Fa'ata'ita'i

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

Tali Fa'ata'ita'i

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

Faʻatonu le DNS

Faʻaopopo se tala fou DNS i se itu faapitoa (ala i totonu).

Talosaga mo Fa'atulagaga o le Tino

Talosaga Fa'ata'ita'i

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

Fa'ailoga o Tulaga o Tali

Faʻatonu le DNS Recording (Direct Access)

Fa'atinoga CRUD atoa i fa'amaumauga DNS ta'itasi e fa'aaoga ai le UUID o le fa'amaumauga.

Faʻagaioiga e maua

• 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

Faʻatonu le Faʻatonu (mo le GET /api/v1/dns-records/)

Faʻafouina le TTL o se faʻamaumauga

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

Faʻatulagaga sili

Faʻatonu

• Faʻaputuga (faʻasolosolo): 3600-86400 sekone (1-24 itula)
• Aʻo leʻi femalagaiga: 300-600 sekone (5-10 minute) - TTL maualalo ae le i faia suiga faatulagaina
• Faʻaleleia: 300-1800 sekone (5-30 minute) mo le suʻesuʻeina vave

Paʻi

• Nofoaga @: Faʻaaoga faʻamaumauga A/AAAA, e le CNAME
• www subdomain: E mafai ona faʻaaogaina le CNAME e faʻasino i le root poʻo le faʻavasegaina o se faʻamaumauga A
• imeli (MX): Faʻaopopo pea le faʻaeteete, numera maualalo = faʻaeteete maualuga atu
• CNAME: E le mafai ona fegalegaleai ma isi ituaiga o faʻamaumauga mo le igoa tutusa

Faʻatulafonoina

• CAA Records: Faʻailoa poʻo a CA e mafai ona faʻaulu faʻamaonia
• SPF/DKIM/DMARC: Faʻatulagaina o le faʻamaonia o imeli e puipuia ai le faʻatupulaia
• Faʻatonu: Faʻamalo faʻamaumauga DNS i le masina, aveese faʻaputuga le faʻaaogaina

Faʻamaopoopoga o Faʻafitauli

Faʻafitauli Faʻapitoa

Faʻatali mo se faʻamatalaga

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

Faʻataʻitaʻiga o suiga DNS

Faʻamaonia le faʻatupulaia o le tusiata

# 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

Faʻaaogaina o meafaigaluega i luga ole laiga

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