API Administrationis DNS

Conspectus

DNS API zonarum et inscriptorum DNS administrationem completam praebet. Totas zonas in VPS.org servibus nominalibus autoritativis cum automatica BIND9 zonae archivi generatione et deploymentum hospitium est.

Infrastructura

• ns1.vps.org (38.248.6.195) - Pagina officialis Dioecesis Inferioris Inferioris
• ns2.vps.org (38.248.6.196) - Pagina secunda
• ns3.vps.org (38.248.6.197) - Pagina secunda

Species principalis

• Pagina officialis Communitatis Autonomae et Territorii Aequatoriae
• Despectus in Viam Aetaterum (via Aetaterum)
• Support for all major DNS record types (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• Nomen in usu est in agricultura et in industria.
• Pagina interretialis de architectura insulae

Authenticatio

Omnes petitiones API DNS authenticationem tokenis portatoris requirit. Tokens API ex tabula contorum generat apud /account/developers/ cum sequuntur permissionibus:

• dns:list - Despectus in Viam Regiam et Viam Regiam
• dns:create - Creare novae zonas et inscriptiones
• dns:update - Modificare zonas et inscriptiones existentes
• dns:delete - Descriptio et inscriptiones
• dns:* - Despectus in Dnipro

Exemplum

Authorization: Bearer vps_abc123def456...

Enumera Omnes Zonas DNS

Recupere paginatam listam omnium zonarum DNS quae utenti authenticato pertinet. Filtrationem per nomen dominii sustinet.

Parametri Quaestionis

Exemplum Petitionis

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

Exemplum Responsionis

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

Campi Responsorum

Codices Status Responsorum

Descriptio descriptio descriptio

Retrieve detailed information about a specific DNS zone, including all records.

Parametri Semitae

Exemplum Responsionis

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

Codices Status Responsorum

Creatio zonae DNS

Novam zonam DNS pro dominio creavit. Zona imediate in VPS.org servorum nominis deployatur.

Parametri Corporis Petitionis

Exemplum Petitionis

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

Exemplum Responsionis

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

Codices Status Responsorum

Despectus in Domus

Deletae sunt zona DNS et omnes inscriptiones ad ea coniunctae. Haec actiones non sunt reversibiles.

Parametri Semitae

Codices Status Responsorum

Index communium praefecturae Aequae

In hoc modo, omnes res in una zona (regione) inveniuntur.

Parametri Semitae

Exemplum Petitionis

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

Exemplum Responsionis

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

Descriptio in pagina archivii

In hoc modo, incolae in novam civitatem (Republicam Foederalem Germaniae) migraverunt.

Parametri Corporis Petitionis

Exemplum Petitionis

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

Codices Status Responsorum

Descriptio (Anglice) Descriptio (Francice)

Full CRUD operations on individual DNS records using record UUID.

Operatio

• 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

Parametra query (for GET /api/v1/dns-records/)

Exemplum: Aetate antiqua inscriptio.

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

Praesides Belgicae

Configuratio TTL

• (Francogallice) (Italiane) 3600–86400 secundae (1–24 horas)
• Ante migrationem: 1000–1050) et usque ad finem saeculi 16 (e.g., 1600) in usu erat.
• Descriptio: 1800–1850) et in 3000 annos a.C.n.

Pagina communis

• Dominium radici (@): A/AAAA inscriptiones, non CNAME, utuntur
• Subdomenium: In hoc modo, ipse potest scripsisse et discere.
• E-mail (MX): Prioritas semper inclusa, numerus minor = prioritas maior
• CNAME: Non potest coexistere cum aliis generis inscriptiorum pro iustum nomen

Securitate

• Index communium praefecturae Aequae Specificare quae CAs certificata emittere possunt
• SPF/DKIM/DMARC: Configurare authenticationem e-mail ut falsificationem impediret
• Regulae periodicae: Index communium praefecturae Aquitaniae Incolae Incolae incolae

Errore manipulatio

Errores communia

Exemplum erroris

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

Despectus in Cantu

Despectus in Rerum Novarum

# 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

Pagina interretialis

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