Maareynta DNS API

Dulmar Guud

DNS API bixiya maareynta buuxda ee gobollada DNS iyo diiwaanada. Gobollada oo dhan waxaa lagu martiqaadayaa servers VPS.org ee magacyada awoodda leh oo leh abuurista iyo soo bandhigida faylka BIND9 ee otomaatiga ah.

Adeegga server-ka magacyada

• ns1.vps.org (38.248.6.195) - Master-ka ugu weyn oo leh DNSSEC inline-sixitaan
• ns2.vps.org (38.248.6.196) - Addoomada labaad
• ns3.vps.org (38.248.6.197) - Addoomada labaad

Sifooyinka muhiimka ah

• Automatic BIND9 zone file abuurista iyo soo bandhigida
• Zone wareejinta ka TSIG authentication (master-slave duubista)
• taageero oo dhan noocyada diiwaanka DNS weyn (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• Magaca domainka ee xakamaynta iyo aqoonsiga UUID-ku saleysan
• Jid ku dhegan oo loogu talagalay maaraynta diiwaanka gobol-gaar ah

Xaqiijinta

DNS API dhammaan codsiyada u baahan yihiin Bearer token xaqiijinta. soo saaro API tokens ka dashboard xisaabtaada at /account/developers/ la idmooyinka soo socda:

• dns:list - Daawo DNS gobollada iyo diiwaanada
• dns:create - abuuro gobollo cusub iyo diiwaanada
• dns:update - Isbeddelka gobollada iyo diiwaanada jira
• dns:delete - Deji meelaha iyo diiwaanada
• dns:* - Full DNS maamulaha helitaanka

tusaale

Authorization: Bearer vps_abc123def456...

Liis garee Dhammaan Aagagga DNS

Soo kabsado liiska pageted ee dhammaan gobollada DNS ay leeyihiin user authenticated. taageertaa filtering by magac domain.

Cabbirrada Weydiinta

Codsi Tusaale ah

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

Jawaabta Tusaale

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

Goobaha Jawaabta

Koodhadhka Xaaladda Jawaab celinta

Ka hesho DNS Zone Faahfaahinta

Soo kabsado macluumaad faahfaahsan oo ku saabsan dhul DNS gaar ah, oo ay ku jiraan diiwaanada oo dhan.

Halbeegyada Wadada

Jawaabta Tusaale

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

Koodhadhka Xaaladda Jawaab celinta

abuuro DNS Zone

Abuur meel cusub oo DNS ah domain. Zone la soo bandhigi doonaa si deg deg ah VPS.org servers.

Codso Cabbirrada Jirka

Codsi Tusaale ah

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

Jawaabta Tusaale

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

Koodhadhka Xaaladda Jawaab celinta

Dib u celi

Si joogto ah u tirtirta dhul DNS iyo dhammaan diiwaanada la xiriira. Falkan ma aha in la joojiyo.

Halbeegyada Wadada

Koodhadhka Xaaladda Jawaab celinta

Liiska DNS Records in Zone

Soo kabsado dhammaan diiwaanada DNS ee dhul gaar ah (jidka ku jira).

Halbeegyada Wadada

Codsi Tusaale ah

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

Jawaabta Tusaale

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

abuuro DNS Record in Zone

Ku dar diiwaanka DNS cusub in dhul gaar ah (jidka nested).

Codso Cabbirrada Jirka

Codsi Tusaale ah

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

Koodhadhka Xaaladda Jawaab celinta

Maareynta DNS Records (Adeegga Tooska ah)

Fulinta hawlgalka CRUD on diiwaanada DNS shakhsiga ah oo isticmaalaya diiwaanka UUID.

Shaqada la heli karo

• 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

Su'aal Parameters (u GET /api/v1/dns-records /)

tusaale: Update TTL of 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

Hababka ugu Fiican

Nidaamka TTL

• Wax soo saarka (dhab ah): 3600-86400 ilbiriqsi (1-24 saacadood)
• Ka hor isbedel: 300-600 ilbiriqsi (5-10 daqiiqo) - TTL hooseeya ka hor isbeddelada qorshaysan
• horumarinta: 300-1800 ilbiriqsi (5-30 daqiiqo) si loo imtixaamo degdeg ah

Noocyada caadiga ah

• Domain root (@): isticmaal A / AAAA diiwaanada, ma CNAME
• www subdomain: Ma isticmaali kartaa CNAME tilmaamo si root ama kala go'aan A record
• _E-mail: Dhammaan ka mid ah hormuudka, tirada hoose = hormuudka sare
• _CNAME: Ma aha in la wada noolaado noocyada kale ee diiwaanka ee magacyada isku midka ah

Ammaanka

• CAA Records: Xusuuso in CAs ay bixi karaan shahaadooyinka
• SPF/DKIM/DMARC: Configure email aqoonsiga si looga hortago spoofing
• xisaabaadka joogtada ah: Dib u eegista DNS diiwaanada quarterly, tirtirto diiwaanada aan la isticmaalin

Xakamaynta khaladaadka

Falalka caadiga ah

Jawaab Faahfaahsan

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

Imtixaan DNS Isbedelada

Ka hubi in la kordhiyay

# 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

Kaararka Online

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