> DNS Pamamahala API

Pangkalahatang-ideya

Ang DNS API ay nagbibigay ng kumpletong pamamahala ng mga zone at mga talaan ng DNS. Lahat ng mga zone ay naka-host sa VPS.org's awtorisadong nameservers na may awtomatikong BIND9 zone file henerasyon at pagpapatupad.

<Impormasyon ng Nameserver

• ns1.vps.org (38.248.6.195) - > Primary master na may DNSSEC inline-signing
• ns2.vps.org (38.248.6.196) - > Sekundaryong alipin
• ns3.vps.org (38.248.6.197) - > Sekundaryong alipin

Mga Susing Katangian

• > Awtomatikong BIND9 zone file henerasyon at pagpapatupad
• > Zone transfer sa pamamagitan ng TSIG authentication (master-alipin replication)
• > Suporta para sa lahat ng mga pangunahing mga uri ng record DNS (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• > Domain pangalan pag-filter at UUID-based zone pagkakakilanlan
• > Nested ruta para sa zone-tukoy na pamamahala ng talaan

Pagpapatotoo

> Lahat ng mga DNS API mga kahilingan ay nangangailangan ng bearer token authentication. Bumuo ng API token mula sa iyong account dashboard sa /account/developers/ > na may mga sumusunod na pahintulot:

• dns:list - > Tingnan ang mga zone DNS at mga tala
• dns:create - > Lumikha ng bagong mga zone at mga tala
• dns:update - > Baguhin ang umiiral na mga zone at mga tala
• dns:delete - > I-delete ang mga zone at mga tala
• dns:* - > Buong DNS pamamahala access

Halimbawa

Authorization: Bearer vps_abc123def456...

Ilista ang Lahat ng DNS Zones

> Bumuo ng isang pag-uuri ng listahan ng lahat ng mga zone DNS pag-aari ng mga authenticated user. Suporta sa pag-filter sa pamamagitan ng pangalan ng domain.

Mga Parameter ng Query

Halimbawang Kahilingan

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

Halimbawang Tugon

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

Mga Patlang ng Tugon

Mga Kodigo ng Katayuan ng Tugon

> Kumuha ng DNS Zone Detalye

> Bumuo ng detalyadong impormasyon tungkol sa isang tiyak na zone DNS, kabilang ang lahat ng mga talaan.

Mga Parameter ng Landas

Halimbawang Tugon

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

Mga Kodigo ng Katayuan ng Tugon

Mag-set up ng DNS Zone

> Lumikha ng isang bagong DNS zone para sa isang domain. Ang zone ay agad na inilunsad sa VPS.org nameservers.

Humiling ng mga Parameter ng Katawan

Halimbawang Kahilingan

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

Halimbawang Tugon

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

Mga Kodigo ng Katayuan ng Tugon

> I-delete ang DNS Zone

> Permanenteng tanggalin ang isang DNS zone at ang lahat ng mga kaugnay na mga tala. Ang aksyon na ito ay hindi maaaring i-undo.

Mga Parameter ng Landas

Mga Kodigo ng Katayuan ng Tugon

> Listahan ng mga talaan ng DNS sa Zone

> Bumalik ang lahat ng mga talaan DNS para sa isang tiyak na zone (nested ruta).

Mga Parameter ng Landas

Halimbawang Kahilingan

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

Halimbawang Tugon

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

> Lumikha ng DNS Record sa Zone

> Magdagdag ng isang bagong record DNS sa isang tiyak na zone (nested ruta).

Humiling ng mga Parameter ng Katawan

Halimbawang Kahilingan

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

Mga Kodigo ng Katayuan ng Tugon

> Pamahalaan ang mga talaan ng DNS (Direct Access)

Ang mga ito ay mga karaniwang ginagamit na mga record ng DNS.

> Available na mga operasyon

• 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

> Query Parameters (para sa GET /api/v1/dns-records/)

Halimbawa: I-update ang TTL ng isang 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

> Pinakamahusay na mga kasanayan

TTL Konfigurasyon

• >Production (matatag): > 3600-86400 segundo (1-24 oras)
• Bago migration: > 300-600 segundo (5-10 minuto) - Mababang TTL bago binalak pagbabago
• Pag-unlad: > 300-1800 segundo (5-30 minuto) para sa mas mabilis na pagsubok

> Karaniwang mga pattern

• > Root domain (@): > Gamitin ang isang / AAAA talaan, hindi CNAME
• > www subdomain: > Maaaring gamitin ang CNAME na tumuturo sa ugat o hiwalay na record ng isang
• Email (hindi kinakailangan) > Laging isama ang prayoridad, mas mababang numero = mas mataas na prayoridad
• CNAME: > Hindi maaaring magkasama sa iba pang mga uri ng record para sa parehong pangalan

Seguridad

• Mga rekord ng CAA: > Tukuyin kung aling CAs maaaring maglabas ng mga sertipiko
• Ang SPF/DKIM/DMARC: > I-configure ang email authentication upang maiwasan ang spoofing
• > Regular na mga Audits: > Repasuhin ang mga talaan ng DNS quarterly, alisin ang mga hindi ginagamit na entry

Error Handling

karaniwang mga error

Halimbawa ng Tugon sa Error

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

Pagsubok ng mga pagbabago sa DNS

> Suriin ang Record pagpapalaganap

# 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

> Paggamit ng Online na Mga Tool

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