API Manajemén DNS

Tinjauan

DNS API nyadiakeun manajemen lengkep tina zona DNS jeung rékor. Sadaya zona dihost dina VPS.org's nameservers otoritas kalawan otomatis BIND9 zona generasi file jeung deployment.

Nameserver Infrastructure

ns1.vps.org (38.248.6.195) - Master utama karo tandatangan ing-line DNSSEC
ns2.vps.org (38.248.6.196) - Anak sekunder
ns3.vps.org (38.248.6.197) - Anak sekunder

Fitur Utama

Penciptaan lan pengembangan file zona BIND9 otomatis
Transfer zona liwat autentikasi TSIG (replikasi master-slave)
Dukungan kanggo kabeh jinis rekaman DNS utama (A, A, CNAME, MX, TXT, NS, SRV, CAA)
Penapisan jeneng domain lan identifikasi zona dumasar UUID
Rute sing diunggah kanggo manajemen rekaman zona-khusus

Autentikasi

Sedaya pitakonan API DNS mbutuhake autentikasi token Bearer. Nyiptakaké token API saka dashboard akun ing /account/developers/ karo ijin ing ngisor iki:

dns:list - Lihat zona lan catatan DNS
dns:create - Nggawe zona anyar lan rekor
dns:update - Ubah zona lan rekor sing ana
dns:delete - Hapus zona lan rekor
dns:* - Akses manajemen DNS lengkap

Conto

Authorization: Bearer vps_abc123def456...

Penting: Token API ngan ditempo sakali nalika diciptakeun. Simpenana sacara aman. Upami anjeun leungitkeun token, anjeun kedah nyiptakeun anu anyar.

MEUNANGKEUN /api/v1/dns-zones/

Daptarkeun Sadaya Zona DNS

Ngumpulkeun daftar paged sakabéh zona DNS anu dimiliki ku pangguna anu diautentikasi. Ngadukung panyaring ku nami domain.

Parameter Pamundut

Parameter	Tipe	Diperlukeun	Gambaran
`domain`	string	Ora	Filter zones by exact domain name (e.g., `example.com`)

Conto Pamundut

cURL

Python

JavaScript

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

Conto Réspon

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

Widang Tanggapan

Lapangan	Tipe	Gambaran
`uuid`	string	Unique zone identifier (used in API requests)
`domain`	string	Domain name for this DNS zone
`created_at`	datetime	Zone creation timestamp (ISO 8601 format)
`record_count`	integer	Total number of DNS records in this zone

Kodeu Status Tanggapan

200	Successfully retrieved DNS zones list
401	Unauthorized - Invalid or missing API token
403	Forbidden - Token lacks `dns:list` permission

MEUNANGKEUN /api/v1/dns-zones/{uuid}/

Muat turun DNS Zone Details

Ngarekam informasi rinci ngeunaan zona DNS husus, kalebet sadaya rékor.

Parameter Jalur

Parameter	Tipe	Diperlukeun	Gambaran
`uuid`	string	Muhun	Unique zone identifier

Conto Réspon

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

Kodeu Status Tanggapan

200	Successfully retrieved zone details
404	Zone not found or not owned by user

POST /api/v1/dns-zones/

Nggawe Domain

Nyiptakeun zona DNS anyar pikeun domain. Zona bakal langsung diterapkeun ka VPS.org pelayan nami.

Pamundut Parameter Awak

Parameter	Tipe	Diperlukeun	Gambaran
`domain`	string	Muhun	Domain name (e.g., `example.com`)

Conto Pamundut

cURL

Python

JavaScript

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

Conto Réspon

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

Kodeu Status Tanggapan

201	DNS zone created successfully
400	Bad Request - Invalid domain name or zone already exists
403	Forbidden - Token lacks `dns:create` permission

HAPUS /api/v1/dns-zones/{uuid}/

Hapus Zona DNS

Pamekar zona DNS sarta sadaya rékor anu aya hubunganana sacara permanen. Tindakan ieu teu bisa dibatalkeun.

Parameter Jalur

Parameter	Tipe	Diperlukeun	Gambaran
`uuid`	string	Muhun	Unique zone identifier

Kodeu Status Tanggapan

204	Zone deleted successfully (no response body)
403	Forbidden - Token lacks `dns:delete` permission
404	Zone not found

MEUNANGKEUN /api/v1/dns-zones/{uuid}/records/

Daftar rekaman DNS ing zona

Nganggo kabeh rekaman DNS kanggo zona tartamtu (rute bersilang).

Parameter Jalur

Parameter	Tipe	Diperlukeun	Gambaran
`uuid`	string	Muhun	Zone UUID

Conto Pamundut

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

Conto Réspon

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

POST /api/v1/dns-zones/{uuid}/records/

Nggawe rekor DNS ing zona

Tambahake rekaman DNS anyar ka zona khusus (rute anu diukir).

Pamundut Parameter Awak

Parameter	Tipe	Diperlukeun	Gambaran
`record_type`	string	Muhun	Record type: A, AAAA, CNAME, MX, TXT, NS, SRV, CAA
`name`	string	Muhun	Record name (`@` for root, subdomain, or FQDN)
`value`	string	Muhun	Record value (IP address, hostname, text)
`ttl`	integer	No	Time to live in seconds (default: 3600)
`priority`	integer	For MX/SRV	Priority (required for MX and SRV records)

Conto Pamundut

cURL

Python

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

Kodeu Status Tanggapan

201	DNS record created successfully
400	Bad Request - Invalid parameters or validation error (e.g., MX record missing priority)

GET PUT PATCH DELETE /api/v1/dns-records/{uuid}/

Manajemen DNS Record (Akses langsung)

Saben domain dipérang dadi subdomain kanthi jeneng sing padha.

Operasi kang ana

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 pitakonan (kanggo GET /api/v1/dns-records/)

Parameter	Tipe	Gambaran
`zone`	string	Filter records by zone UUID
`record_type`	string	Filter by record type (A, AAAA, MX, etc.)

Contoh: Ngajalajah TTL rekaman

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

Tipe	Purpose	Example Value	Priority Required
A	Maps domain to IPv4 address	192.0.2.1	Ora
AAAA	Maps domain to IPv6 address	2001:0db8::1	Ora
CNAME	Creates alias to another domain	example.com	Ora
MX	Mail server for domain	mail.example.com	Muhun
TXT	Text record (SPF, DKIM, verification)	v=spf1 include:_spf.google.com ~all	Ora
NS	Nameserver delegation	ns1.example.com	Ora
SRV	Service location record	10 5060 sip.example.com	Muhun
CAA	Certificate authority authorization	0 issue "letsencrypt.org"	Ora

Praktik Paling Apik

Konfigurasi TTL

Produksi (stabil): 3600-86400 detik (1-24 jam)
Sadurunge migrasi: 300-600 detik (5-10 menit) - TTL kurang sadurunge perubahan sing direncanakake
Pangembang: 300-1800 detik (5-30 menit) kanggo pengujian luwih cepet

Tembung

Domain akar (@): Gunake rekaman A/A, ora CNAME
subdomain www: Bisa nggunakake CNAME kanggo nyambung menyang root utawa ngepisahake rekaman A
Эл. почта (MX): Selalu nyakup prioritas, angka kang luwih endhek = prioritas sing luwih dhuwur
CNAME: Ora bisa koeksisten karo jinis rekaman liyane kanggo jeneng sing padha

Keamanan

CAA Records: Nyathet CA kang bisa ngetokake sijil
SPF/DKIM/DMARC: Nggawe autentikasi email kanggo nyegah spoofing
Audits Reguler: Ngrekam DNS saben wulan, mbusak entri sing ora digunakake

Ngatur Kesalahan

Kesalahan umum

Kode Status	Kesalahan	Solusi
400	Nama domain ora sah	Nyatane domain ngetutake konvensi jeneng DNS
400	Rekor MX butuh prioritas	Ngemot `priority` MX жана SRV жазуу үчүн
401	Token API ora sah	Verifikasi format token (kudu diwiwiti karo `vps_`)
403	Keizinan ilang	Ngembangake token anyar karo dibutuhake `dns:*` Permissions
404	Zona/rekaman ora ditemoka	Nyatakake UUID lan priksa manawa sumber daya iku milik akunmu

Conto Jawaban Kesalahan

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

Nguji perubahan DNS

Nyatakan penyebaran rekaman

# 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

Menggunakan Alat Online

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

VPS.org API

API Manajemén DNS

Tinjauan

Nameserver Infrastructure

Fitur Utama

Autentikasi

Conto

Daptarkeun Sadaya Zona DNS

Parameter Pamundut

Conto Pamundut

Conto Réspon

Widang Tanggapan

Kodeu Status Tanggapan

Muat turun DNS Zone Details

Parameter Jalur

Conto Réspon

Kodeu Status Tanggapan

Nggawe Domain

Pamundut Parameter Awak

Conto Pamundut

Conto Réspon

Kodeu Status Tanggapan

Hapus Zona DNS

Parameter Jalur

Kodeu Status Tanggapan

Daftar rekaman DNS ing zona

Parameter Jalur

Conto Pamundut

Conto Réspon

Nggawe rekor DNS ing zona

Pamundut Parameter Awak

Conto Pamundut

Kodeu Status Tanggapan

Manajemen DNS Record (Akses langsung)

Operasi kang ana

Parameter pitakonan (kanggo GET /api/v1/dns-records/)

Contoh: Ngajalajah TTL rekaman

Supported DNS Record Types

Praktik Paling Apik

Konfigurasi TTL

Tembung

Keamanan

Ngatur Kesalahan

Kesalahan umum

Conto Jawaban Kesalahan

Nguji perubahan DNS

Nyatakan penyebaran rekaman

Menggunakan Alat Online