API-ja e Menaxhimit të DNS-së

Përmbledhje

API e DNS ofron menazhimin e plotë të zonave dhe regjistrave të DNS. Të gjitha zonat janë të vendosura në serverat e emrave autoritativë të VPS.org me krijimin dhe shpërndarjen automatike të file të zonave BIND9.

Infrastruktura e serverit të emrit

• ns1.vps.org (38.248.6.195) - Master primar me firmosje në rresht DNSSEC
• ns2.vps.org (38.248.6.196) - Skllav i dytë
• ns3.vps.org (38.248.6.197) - Skllav i dytë

Funksionet kryesore

• Gjenerati automatik i file të zonës BIND9 dhe vendosja
• Transferimet e zonës nëpërmjet autentifikimit TSIG (kopjimi master-slave)
• Suport për të gjitha llojet e mëdha të regjistrave DNS (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• Filtrimi i emrave të domain dhe identifikimi i zonave bazuar në UUID
• Rrugë të ndërlikuara për menazhimin e regjistrave specifikë të zonës

Autentifikimi

Të gjitha kërkesat e API DNS kërkojnë autentifikimin me token e bartësit. Gjenerati token e API nga paneli i llogarisë në /account/developers/ me të drejtat në vijim:

• dns:list - Shiko zonat dhe regjistrat DNS
• dns:create - Krijo zona dhe rekorde të reja
• dns:update - Ndrysho zonat dhe regjistrat ekzistues
• dns:delete - Elemino zonat dhe regjistrat
• dns:* - Përdorim i plotë i menazhimit të DNS

Shembull

Authorization: Bearer vps_abc123def456...

Listo të gjitha zonat DNS

Merr një listë të faqes së të gjitha zonave DNS që i përkasin përdoruesit të autentifikuar. Suporton filtrimin sipas emrit të domain.

Parametrat e pyetjes

Shembull Kërkese

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

Shembull Përgjigjeje

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

Fushat e Përgjigjes

Kodet e Statusit të Përgjigjes

Merr hollësitë e zonës DNS

Merr informacione të hollësishme rreth një zone të caktuar DNS, duke përfshirë të gjitha regjistrat.

Parametrat e Shtegut

Shembull Përgjigjeje

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

Kodet e Statusit të Përgjigjes

Krijo zonën DNS

Krijo një zonë të re DNS për një domen. Zona do të vendoset menjëherë tek VPS.org serverë emrash.

Parametrat e Trupit të Kërkesës

Shembull Kërkese

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

Shembull Përgjigjeje

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

Kodet e Statusit të Përgjigjes

Elemino zonën DNS

Elemino përgjithmonë një zonë DNS dhe të gjitha regjistrat e lidhur me të. Ky veprim nuk mund të anullohet.

Parametrat e Shtegut

Kodet e Statusit të Përgjigjes

Lista e rregjistrave DNS në zonë

Merr të gjitha regjistrat DNS për një zonë të caktuar (rrugë e fshehur).

Parametrat e Shtegut

Shembull Kërkese

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

Shembull Përgjigjeje

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

Krijo një rekord DNS në zonë

Shto një regjistrim të ri DNS në një zonë të caktuar (rrugë e fshehur).

Parametrat e Trupit të Kërkesës

Shembull Kërkese

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

Kodet e Statusit të Përgjigjes

Menazho regjistrat DNS (Shfrytëzim i drejtpërdrejtë)

Operacionet e plota CRUD në regjistrat individualë DNS duke përdorur UUID të regjistrit.

Operacionet në dispozicion

• 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

Parametrat e pyetjes (për GET /api/v1/dns-records/)

Përditëso

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

Praktika më e mirë

Konfigurimi i TTL

• Prodhimi (stabil): 3600-86400 sekonda (1-24 orë)
• Para migrimit: 300-600 sekonda (5-10 minuta) - Ulja e TTL para ndryshimeve të planifikuara
• Zhvillimi: 300-1800 sekonda (5-30 minuta) për testime më të shpejta

Modele të zakonshme

• Domain root (@): Përdor rregjistra A/AAAA, jo CNAME
• Nëndomeni www: Mund të përdoret CNAME që tregon tek rrënja ose të ndarë nga një rekord A
• Email (MX): Përfshi gjithmonë përparësinë, numri më i ulët = përparësi më e lartë
• CNAME: Nuk mund të bashkëekziston me lloje të tjera të regjistrave për të njëjtin emër

Siguria

• CAA Records: Specifiko se cilat CA mund të lëshojnë çertifikata
• SPF/DKIM/DMARC: Konfiguro autentifikimin e email për të parandaluar falsifikimin
• Kontrollet e rregullta: Shiko rregjistrimet e DNS çdo tre muaj, hiq hyrjet e papërdorura

Manipulimi i gabimeve

Gabime të zakonshme

Përgjigja e gabimit

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

Duke testuar ndryshimet DNS

Kontrollo përhapjen e regjistrit

# 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

Duke përdorur instrumentët në linjë

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