API គ្រប់គ្រង DNS

ទិដ្ឋភាពទូទៅ

DNS API ផ្តល់ការគ្រប់គ្រងពេញលេញនៃតំបន់ DNS និងកំណត់ត្រា។ តំបន់ទាំងអស់ត្រូវបានរៀបចំនៅលើម៉ាស៊ីនបម្រើឈ្មោះដែលមានសិទ្ធិអំណាចរបស់ VPS.org ជាមួយការបង្កើតនិងបញ្ជូនឯកសារតំបន់ BIND9 ដោយស្វ័យប្រវត្តិ។

ហេដ្ឋារចនាសម្ព័ន្ធ​ម៉ាស៊ីន​បម្រើ​ឈ្មោះ

• ns1.vps.org (38.248.6.195) - មេ​ចម្បង​ជាមួយ​ការ​ចុះហត្ថលេខា​ក្នុង​បន្ទាត់ DNSSEC
• ns2.vps.org (38.248.6.196) - កូន​កាត់​រង
• ns3.vps.org (38.248.6.197) - កូន​កាត់​រង

លក្ខណៈ​ពិសេស​សំខាន់

• ការ​បង្កើត និង​ការ​បែងចែក​ឯកសារ​តំបន់ BIND9 ដោយ​ស្វ័យប្រវត្តិ
• តំបន់​ផ្ទេរ​តាម​រយៈ​ការ​ផ្ទៀងផ្ទាត់​ភាព​ត្រឹមត្រូវ TSIG (ចម្លង​មេ- slave)
• គាំទ្រសម្រាប់ប្រភេទកំណត់ត្រា DNS សំខាន់ៗទាំងអស់ (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
• ការ​ត្រង​ឈ្មោះ​ដែន និង​ការ​កំណត់​អត្តសញ្ញាណ​តំបន់​ដែល​មាន​មូលដ្ឋាន​លើ UUID
• ផ្លូវ​ដែល​បាន​ដាក់​ក្នុង​ចន្លោះ​សម្រាប់​ការ​គ្រប់គ្រង​កំណត់ហេតុ​ជាក់លាក់​តំបន់

ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ

សំណើ API DNS ទាំងអស់ត្រូវការការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវរបស់ Token Bearer ។ បង្កើត Token API ពីអេក្រង់គ្រប់គ្រងគណនីរបស់អ្នកនៅ /account/developers/ ជាមួយ​នឹង​សិទ្ធិ​ដូច​ខាង​ក្រោម & # 160; ៖

• dns:list - មើល​តំបន់ និង​កំណត់ហេតុ DNS
• dns:create - បង្កើត​តំបន់ និង​កំណត់ហេតុ​ថ្មី
• dns:update - កែប្រែ​តំបន់ និង​កំណត់ហេតុ​ដែល​មាន​ស្រាប់
• dns:delete - លុប​តំបន់ និង​កំណត់ហេតុ
• dns:* - ការ​ចូលដំណើរការ​គ្រប់គ្រង DNS ពេញលេញ

ឧទាហរណ៍

Authorization: Bearer vps_abc123def456...

រាយបញ្ជីតំបន់ DNS ទាំងអស់

យក​បញ្ជី​ទំព័រ​នៃ​តំបន់ DNS ទាំងអស់​ដែល​ជា​កម្មសិទ្ធិ​របស់​អ្នក​ប្រើ​ដែល​បាន​ផ្ទៀងផ្ទាត់​ភាព​ត្រឹមត្រូវ & # 160; ។ គាំទ្រ​ការ​ត្រង​តាម​ឈ្មោះ​ដែន & # 160; ។

ប៉ារ៉ាម៉ែត្រសំណួរ

សំណើឧទាហរណ៍

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

ឧទាហរណ៍នៃការឆ្លើយតប

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

វាលឆ្លើយតប

លេខកូដស្ថានភាពឆ្លើយតប

យក​សេចក្ដី​លម្អិត​តំបន់ DNS

យក​ព័ត៌មាន​លម្អិត​អំពី​តំបន់ DNS ជាក់លាក់ រួម​ទាំង​កំណត់​ហេតុ​ទាំងអស់ & # 160; ។

ប៉ារ៉ាម៉ែត្រផ្លូវ

ឧទាហរណ៍នៃការឆ្លើយតប

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

លេខកូដស្ថានភាពឆ្លើយតប

បង្កើត​តំបន់ DNS

បង្កើត​តំបន់ DNS ថ្មី​សម្រាប់​ដែន & # 160; ។ តំបន់​នឹង​ត្រូវ​បាន​បញ្ជូន​ភ្លាមៗ​ទៅ​ម៉ាស៊ីន​បម្រើ​ឈ្មោះ VPS.org & # 160; ។

ស្នើសុំប៉ារ៉ាម៉ែត្រតួ

សំណើឧទាហរណ៍

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

ឧទាហរណ៍នៃការឆ្លើយតប

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

លេខកូដស្ថានភាពឆ្លើយតប

លុប​តំបន់ DNS

លុប​តំបន់ DNS និង​កំណត់ហេតុ​ដែល​បាន​ភ្ជាប់​ទាំងអស់​ជា​អចិន្ត្រៃយ៍ & # 160; ។ អំពើ​នេះ​មិន​អាច​មិន​ធ្វើ​វិញ​បាន​ទេ & # 160; ។

ប៉ារ៉ាម៉ែត្រផ្លូវ

លេខកូដស្ថានភាពឆ្លើយតប

រាយ​កំណត់ហេតុ DNS ក្នុង​តំបន់

យក​កំណត់ហេតុ DNS ទាំងអស់​សម្រាប់​តំបន់​ជាក់លាក់ (ផ្លូវ​ដែល​បាន​ដាក់​ក្នុង​ចន្លោះ) & # 160; ។

ប៉ារ៉ាម៉ែត្រផ្លូវ

សំណើឧទាហរណ៍

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

ឧទាហរណ៍នៃការឆ្លើយតប

[
  {
    "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 ថ្មី​ទៅ​តំបន់​ជាក់លាក់ (ផ្លូវ​ដែល​បាន​ដាក់​ក្នុង​ចន្លោះ) & # 160; ។

ស្នើសុំប៉ារ៉ាម៉ែត្រតួ

សំណើឧទាហរណ៍

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

លេខកូដស្ថានភាពឆ្លើយតប

គ្រប់គ្រង​កំណត់ហេតុ DNS (ចូលដំណើរការ​ដោយ​ផ្ទាល់)

ប្រតិបត្តិការ CRUD ពេញលេញ​លើ​កំណត់ហេតុ DNS ឯកជន​ដោយ​ប្រើ​កំណត់ហេតុ UUID & # 160; ។

ប្រតិបត្តិការ​ដែល​មាន

• 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 /)

ឧទាហរណ៍ & # 160; ៖ ធ្វើ​ឲ្យ​ 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

• ផលិតកម្ម (ស្ថេរ) & # 160; ៖ 3600-86400 វិនាទី (1-24 ម៉ោង)
• មុន​ពេល​ប្ដូរ​ទីតាំង & # 160; ៖ 300-600 វិនាទី (5-10 នាទី) - បន្ថយ TTL មុនពេលមានការផ្លាស់ប្តូរដែលបានគ្រោងទុក
• ការ​អភិវឌ្ឍ & # 160; ៖ 300-1800 វិនាទី (5-30 នាទី) សម្រាប់ការធ្វើតេស្តលឿនជាងមុន

លំនាំ​ទូទៅ

• ដែន root (@) & # 160; ៖ ប្រើ​កំណត់ហេតុ A/AAAA មិនមែន CNAME ទេ
• ដែន​រង www & # 160; ៖ អាច​ប្រើ CNAME ចង្អុល​ទៅ root ឬ​បំបែក​កំណត់ហេតុ A
• អ៊ីមែល (MX) & # 160; ៖ រួម​បញ្ចូល​អាទិភាព​ជានិច្ច លេខ​ទាប = អាទិភាព​ខ្ពស់
• CNAME & # 160; ៖ មិន​អាច​រួម​រស់​ជាមួយ​ប្រភេទ​កំណត់​ហេតុ​ផ្សេង​ទៀត​សម្រាប់​ឈ្មោះ​ដូចគ្នា​បាន​ទេ

សុវត្ថិភាព

• កំណត់ហេតុ CAA & # 160; ៖ បញ្ជាក់​ថា​ CA ណា​អាច​ចេញ​វិញ្ញាបនបត្រ
• SPF/ DKIM/ DMARC & # 160; ៖ កំណត់​រចនាសម្ព័ន្ធ​ការ​ផ្ទៀងផ្ទាត់​ភាព​ត្រឹមត្រូវ​អ៊ីមែល​ដើម្បី​ការពារ​ការ​លួច​បន្លំName
• ការ​ត្រួតពិនិត្យ​ជា​ប្រចាំ & # 160; ៖ ពិនិត្យ​មើល​កំណត់ហេតុ 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