API-ya Rêvebiriya DNS-ê

Têgihiştinî

دی ئێن ئێس ئەپی پی بەڕێوەبردنی تەواو دەدات بە ناوچەکانی دی ئێن ئێس و تۆمارەکان. هەموو ناوچەکان لەسەر VPS.org's authority name servers دادەنرێن لەگەڵ دروستکردنی ئۆتۆماتیکی BIND9 zone file و دابەشکردنی.

ناو:

• ns1.vps.org (38.248.6.195) - پەرەپێدەری سەرەکی بە ئیمزاکردنی ناوەوەی DNSSEC
• ns2.vps.org (38.248.6.196) - بەندەی دووهەم
• ns3.vps.org (38.248.6.197) - بەندەی دووهەم

تایبەتمەندی سەرەکی

• دروستکردنی خۆکارانەی فایلی ناوچەی BIND9 و دابەشکردنی
• گەڕان بەدوای شوێندا لە ڕێگەی TSIG (Master-Slave replication)
• پشتگیری بۆ هەموو جۆرەکانی تۆماری DNS (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• ناوەکانی دۆمەینەکان پاڵاوتن دەکەن و شوێنی UUID-ی پێناسەیان پێدەدرێت
• ڕێگایەکی بەستراو بۆ بەڕێوەبردنی تۆماری تایبەت بە ناوچەی

Rastkirin

هەموو داواکاریەکانی ئەپی پی ئێن پێویستی بە ناساندنی نیشانەی بارکەر هەیە. نیشانەی ئەپی پی لە داشبۆردی هەژمارەکەت دروست بکە لە /account/developers/ بە مۆڵەتی خوارەوە:

• dns:list - بینینی ناوچەکانی DNS و تۆمارەکان
• dns:create - دروستکردنی شوێن و تۆماری نوێ
• dns:update - گۆڕینی ناوچەکان و تۆمارە هەنووکەییەکان
• dns:delete - نوسراوەکانت بگۆڕە
• dns:* - گەیشتنی تەواو بۆ بەڕێوەبردنی DNS

نمونە

Authorization: Bearer vps_abc123def456...

Hemû Herêmên DNS-ê Lîst bike

لیستێکی پەڕەیی لە هەموو ناوچەکانی DNS وەرگرە کە خاوەنەکەی بەکارهێنەرێکی ڕاستەوخۆیە. پشتگیری لە پاڵاوتن دەکات بە ناوی دۆمەین.

Parametreyên Lêpirsînê

Daxwaza Nimûne

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

Bersiva Mînakî

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

Zeviyên Bersivê

Kodên Rewşa Bersivê

زانیارییەکانی ناوچەی DNS بەدەست بهێنە

زانیارییە وردەکان دەربارەی ناوچەی دیاریکراوی DNS بەدەست بهێنە، لەگەڵ هەموو تۆمارەکان.

Parametreyên Rêyê

Bersiva Mînakî

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

Kodên Rewşa Bersivê

دروستکردنی ناوچەی DNS

Create a new DNS zone for a domain. The zone will be immediately deployed to VPS.org nameservers.

Parametreyên Laşê Daxwazê

Daxwaza Nimûne

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

Bersiva Mînakî

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

Kodên Rewşa Bersivê

بەشی DNS هەڵبگرە

بۆ هەمیشە ناوچەیەکی DNS و هەموو تۆمارە پەیوەندیدارەکانت هەڵبگرە. ئەم کردارە ناتوانرێت هەڵبگیرێت.

Parametreyên Rêyê

Kodên Rewşa Bersivê

تۆماری DNS لە ناوچەکەدا تۆمار بکە

هەموو تۆمارەکانی DNS بۆ ناوچەی دیاریکراو وەرگرە (ڕێگای بەستراو).

Parametreyên Rêyê

Daxwaza Nimûne

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

Bersiva Mînakî

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

دروستکردنی تۆماری DNS لە ناوچەی

تۆماری نوێی DNS زیاد بکە بۆ ناوچەی دیاریکراو (ڕێگای ناوەوەی).

Parametreyên Laşê Daxwazê

Daxwaza Nimûne

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

Kodên Rewşa Bersivê

بەڕێوەبردنی تۆمارەکانی DNS (دەسەڵاتی ڕاستەوخۆ)

پڕۆسەی تەواوکردنی CRUD لەسەر تۆماری DNS بە بەکارهێنانی تۆماری UUID.

پڕۆسەی دەستەبەرکراو

• 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

پارامەترەکانی پرسیار (بۆ GET /api/v1/dns-records/)

نمونە: نوێکردنەوەی TTL ی تۆمارێک

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

باشترین کار

ڕێکخستنی TTL

• بەرهەمهێنان (ستاندارد): 3600-86400 چرکە (1-24 کاتژمێر)
• پێش گواستنەوەی: 300-600 چرکە (5-10 خولەک) - کەمکردنەوەی TTL پێش گۆڕانکارییە پلاندارەکان
• گەشەپێدان: 300-1800 چرکە (5-30 خولەک) بۆ تاقیکردنەوە خێراتر

نمونە گشتیەکان

• دامەزرێنەر تۆماری A/AAAA بەکاربهێنە نەک CNAME
• ماڵپەڕی ژێر: دەتوانیت نیشاندانی CNAME بەکاربهێنیت بۆ ریشە یان تۆماری A دابەشکراو
• ئیمەیلی (MX): هەمیشە پێشەنگی تێدابکە، ژمارەی کەمتر = پێشەنگی بەرزتر
• _ناو: ناتوانرێت لەگەڵ جۆرەکانی تۆماری تردا بۆ هەمان ناو بژین

_پارێزە

• تۆماری CAA: Specify which CAs can issue certificates
• SPF/DKIM/DMARC: ڕێکخستنی ناساندنی ئیمەیڵ بۆ ڕێگریکردن لە دزینی زانیاری
• چاودێریکردنی ئاسایی: تۆمارەکانی DNS بە چوار قۆناغ پشکنین، تۆمارە بەکارنەهاتووەکان لادەبە

هەڵە

هەڵە گشتیەکان

نمونەی وەڵامدانەوەی هەڵە

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

تاقیکردنەوەی گۆڕانکاریەکانی DNS

پشکنینی بڵاوبوونەوەی تۆمار

# 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

بەکارهێنانی ئامرازەکانی ئینتەرنێت

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