API ya Usimamizi wa DNS

Muhtasari

Maeneo yote yana watu VPS.org walio na jina maarufu kwa ajili ya ujenzi wa BAND9 katika ukanda wa dunia wa BIND9 na vikosi vya kijeshi.

Majina Yasiyo na Maana

• ns1.vps.org (38.248.6.195) - Msimamizi wa kwanza wa shirika la DNSSEC akiwa na ishara ya mkono
• ns2.vps.org (38.248.6.196) - Mtumwa wa pili
• ns3.vps.org (38.248.6.197) - Mtumwa wa pili

Sehemu Kuu

• Eneo la dunia la Automatic BIND9 hurekodi kizazi na shughuli za kijeshi
• Uhamishaji wa Zone kupitia uwakilishi wa TSIG
• Kutegemeza aina zote kuu za DNS (A, AAAA, CNME, MX, STT, NS, SRV, CAA)
• Jina la Kimain uchujaji na utambulisho wa eneo la dunia lililoko nchini UUID
• Njia zilizoundwa kwa ajili ya usimamizi wa rekodi za eneo la dunia

Uthibitishaji

Kila kitu mnachoomba kinahitaji cheti cha kuthibitisha usahihi wa chembe za urithi. /account/developers/ kwa ruhusa zifuatazo:

• dns:list - Ona kanda na rekodi za DNS
• dns:create - Andaa kanda na rekodi mpya
• dns:update - Punguza kanda na rekodi zilizopo
• dns:delete - Maeneo na rekodi zenye giza
• dns:* - Utumizi kamili wa DNS

Mfano

Authorization: Bearer vps_abc123def456...

Orodhesha Maeneo Yote ya DNS

Andika orodha ya kanda zote za DNS zilizomilikiwa na mtumiaji aliyethibitishwa.

Vigezo vya Hoja

Ombi la Mfano

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

Jibu la Mfano

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

Sehemu za Majibu

Misimbo ya Hali ya Majibu

Tafuta Habari Zaidi Katika Eneo la DNS

Toa habari kamili kuhusu eneo fulani hususa la DNS, kutia ndani rekodi zote.

Vigezo vya Njia

Jibu la Mfano

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

Misimbo ya Hali ya Majibu

Create DNS Zone

Andaa eneo jipya la DNS kwa ajili ya makazi. Eneo hilo litatumiwa mara moja na watu VPS.org wanaohifadhi majina.

Omba Vigezo vya Mwili

Ombi la Mfano

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

Jibu la Mfano

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

Misimbo ya Hali ya Majibu

Delette DNS Zone

Kufuta kabisa eneo la DNS na rekodi zote zinazohusika.

Vigezo vya Njia

Misimbo ya Hali ya Majibu

Orodha ya Matukio ya DNS huko Zone

Chunguza rekodi zote za DNS kwa ajili ya eneo fulani hususa (lililipotumiwa kwa njia maalumu).

Vigezo vya Njia

Ombi la Mfano

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

Jibu la Mfano

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

Create DNS in Zone

Ongeza rekodi mpya ya DNS kwenye eneo fulani hususa (lililipotumiwa kwa njia fulani).

Omba Vigezo vya Mwili

Ombi la Mfano

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

Misimbo ya Hali ya Majibu

Retection DNS Records (Kinumo cha Mfumo wa Maeneo ya Mbali)

UKOMBOLEO kamili kwenye rekodi moja - moja za DNS kwa kutumia rekodi ya UUID.

Utendaji Upatikanao

• 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

Query Paramitas (kwa ajili ya kuikomboa /api/v1/dns-records/)

Mfano: Habari Mpya Kuhusu Rekodi

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

Mazoea Bora

TTL Confession

• Utokezwaji (uwezekane): Saa 3600-86,400 (saa 1 hadi 24)
• Kabla ya kuhama: Semita 300-600 (jumu 5-10) - Lower TTL kabla ya mabadiliko kupangwa
• Maendeleo: Dakika 300-1800 kwa majaribio ya haraka zaidi

Maumbo ya Kawaida

• Picha ya msingi (@): Tumia rekodi za A/AAAAA, si CNME
• www.domain: Waweza kutumia CNME ikielekeza kwenye mzizi au kwenye rekodi ya A
• Barua pepe (MX): Sikuzote ni pamoja na mambo ya kutangulizwa, namba ya chini = kipaumbele cha juu zaidi
• CNME: Hawawezi kuishi pamoja na aina nyingine za maandishi kwa ajili ya jina lilo hilo

Usalama

• KAA Records: Specify ambacho Cles anaweza kutoa vyeti
• SPF/DKIM/DMARC: Stock label
• Raia wa Kawaida: Taasisi ya CTNS hurekodi kila kitu, ikiondoa mambo ambayo hayajatumiwa

Kushughulikia Vibaya

Makosa ya Kawaida

Itikio Lisilofaa la Mfano

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

Kutahini Mabadiliko ya DNS

Rekodi Yenye Kusadikisha Yatoa Unabii

# 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

Kutumia Vifaa vya Intaneti

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