API ɗin Gudanar da DNS

Bayani

The DNS API provides full management of DNS zones and records. All zones are hosted on VPS.org's authoritative nameservers with automatic BIND9 zone file generation and deployment.

Nameservers

• ns1.vps.org (38.248.6.195) - Mai kula da farko da sanarwar DNSSEC cikin-layin
• ns2.vps.org (38.248.6.196) - KCharselect unicode block name
• ns3.vps.org (38.248.6.197) - KCharselect unicode block name

QPrintPreviewDialog

• Yiwa fayil na yanki BIND9 halitta da rabawa cikin sauri
• Canja wurin yanki ta hanyar shaidar TSIG (mai-ma'aikacin rikodin)
• go
• Cire sunan domena da UUID-da aka dogara kan ganewa na yanki
• Phonon:: MMF:: EffectFactory

Tabbatarwa

Duk tambayoyin API na DNS suna buƙatar tabbatarwa da tabbaci na tabbaci. Yi amfani da tabbacin API daga dashboard ɗin asusunka a /account/developers/ da izinin da ke ƙasa:

• dns:list - Nuna yankuna da rubuce-rubucen DNS
• dns:create - @ action
• dns:update - @ action
• dns:delete - @ action
• dns:* - Cire haɗin kula da DNS

@ action

Authorization: Bearer vps_abc123def456...

Jerin Duk Yankunan DNS

Mai da jerin shafuka na duk yankuna na DNS da ake da su ga mai amfani da aka tabbatar. Yana goyon bayan siffanta ta hanyar sunan domen.

Sigogin Tambaya

Buƙatar Misali

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

Misalin Amsar

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

Wuraren Amsawa

Lambobin Matsayin Amsawa

@ action

Mai da bayanai masu bayani kan wata yankin DNS, ciki har da duk rikodin.

Sigogi na Hanya

Misalin Amsar

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

Lambobin Matsayin Amsawa

@ action

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

Sigogin Jiki na Neman

Buƙatar Misali

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

Misalin Amsar

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

Lambobin Matsayin Amsawa

@ action

Cire wani yanki na DNS da duk rikodin da ke da alaka da shi. Wannan aikin ba za'a iya dakatar da shi ba.

Sigogi na Hanya

Lambobin Matsayin Amsawa

Nuna rubuce-rubucen DNS cikin yanki

QDialogButtonBox

Sigogi na Hanya

Buƙatar Misali

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

Misalin Amsar

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

@ action

Ƙara wani sabon shigarwa na DNS zuwa wani yanki na musamman (matani mai haɗawa).

Sigogin Jiki na Neman

Buƙatar Misali

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

Lambobin Matsayin Amsawa

Manajan Rikodin DNS (Acces Mai Zuwa)

Ayyuka na CRUD na cikakke kan rikodin DNS na mutum ta amfani da UUID na rikodin.

Aiki

• 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

Parameters na tambaya (don GET /api/v1/dns-records/)

Misali: sabunta TTL na wani rijista

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

QDialogButtonBox

@ action

• @ action 3600-86400 sakan (1-24 sa'o'i)
• Aiki 300-600 sakan (5-10 minti) - Kashe TTL kafin canje-canjen da aka yi wa kwangila
• @ action 300-1800 sakan (5-30 minti) domin gwajin da sauri

KCharselect unicode block name

• @ label: textbox Yi amfani da rubutaccen A/AAAA, ba CNAME ba
• Subdomain: Za'a iya amfani da CNAME mai nunawa zuwa ginshiƙi ko raba wani rajista
• _Imel: @ action
• @ action Ba za'a iya haɗuwa da wasu nau'ikan adana bayanai ba ga sunan da ya dace

QSql

• CAA Records: Ka ƙayyade waɗanne CAs za su iya fitar da takardun shaida
• SPF/DKIM/DMARC: Shirya shaidar imel don hana yin karya
• Aiki Binciken DNS na shekara-shekara, cire shigarwa da ba'a amfani da su ba

QDialogButtonBox

QDialogButtonBox

@ action

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

@ action

QDialogButtonBox

# 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

@ action

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