ສ້າງເຂດ DNS ແລະຄຸ້ມຄອງບັນທຶກຂອງເຂົາເຈົ້າ. ເຂດແມ່ນສະຫນອງໂດຍ ns1.vps.org, ns2.vps.org ແລະ ns3.vps.org.
ເຂດມີບັນທຶກສໍາລັບໂດເມນຫນຶ່ງ. ການປ່ຽນແປງທຸກຢ່າງທີ່ທ່ານເຮັດຜ່ານ API ແມ່ນດຶງໄປທີ່ VPS.org nameservers ທັນທີ. ເພື່ອໃຫ້ບໍລິການໂດເມນຈາກເຂດເຫຼົ່ານີ້, ຕັ້ງຊື່ຂອງເຄື່ອງແມ່ຂ່າຍທີ່ລົງທະບຽນຂອງທ່ານເພື່ອ ns1.vps.org, ns2.vps.org ແລະ ns3.vps.org.
ການປ່ຽນແປງແມ່ນຖືກບັນທຶກ ແລະ ເຜີຍແຜ່ໃນບາດກ້າວດຽວ: ຖ້າຊື່ເຊີບເວີປະຕິເສດການປ່ຽນແປງ, ຄໍາຮ້ອງຂໍຈະກັບຄືນໄປທີ່ 502 ແລະ ບໍ່ມີຫຍັງຈະຖືກບັນທຶກໄວ້. ເຂດບໍ່ສາມາດສ້າງໃຫ້ກັບໂດເມນທີ່ໄດ້ຈັດການໂດຍບັນຊີອື່ນ, ແມ່ ຫຼື ລູກຂອງເຂດຂອງບັນຊີອື່ນ, ຫຼື ຊື່ທີ່ໄດ້ຮັບການກູ້ຢືມ VPS.org.
ຕ້ອງການສິດອຳນາດ:
dns:list (GET), dns:create (POST), dns:update (PUT, PATCH, sync), dns:delete (DELETE), dns:*
ສົ່ງຄືນເຂດຂອງທ່ານ, ໃກ້ສຸດກ່ອນ, 25 ຕໍ່ໜ້າ. ບັນທຶກບໍ່ໄດ້ລວມຢູ່ທີ່ນີ້; ເອົາເຂດດຽວເພື່ອເອົາພວກມັນມາໃຊ້ໄດ້.
| ຕົວເລືອກ | ປະເພດ | ຕ້ອງມີການ | ຄໍາອະທິບາຍ |
|---|---|---|---|
domain |
string | ບໍ່ | ສົ່ງຄືນພຽງແຕ່ເຂດທີ່ມີຊື່ໂດເມນນີ້ເທົ່ານັ້ນ |
page |
integer | ບໍ່ | ຕົວເລກໜ້າ, ເລີ່ມຈາກ 1 |
curl -X GET "https://admin.vps.org/api/v1/dns-zones/?domain=example.com" \
-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, params={"domain": "example.com"})
for zone in response.json()["results"]:
print(zone["uuid"], zone["domain"], zone["record_count"])
const response = await fetch('https://admin.vps.org/api/v1/dns-zones/?domain=example.com', {
headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});
const data = await response.json();
console.log(data.results);
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"uuid": "c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c",
"domain": "example.com",
"created_at": "2026-09-06T03:11:48.829693Z",
"record_count": 5
}
]
}
| ແຄມເປນ | ປະເພດ | ຄໍາອະທິບາຍ |
|---|---|---|
uuid |
string | ຕົວລະບຸເຂດ |
domain |
string | ຊື່ໂດເມນ, ເກັບເປັນຕົວອັກສອນນ້ອຍ |
created_at |
datetime | ເວລາສ້າງ (ISO 8601, UTC) |
record_count |
integer | ຈໍານວນບັນທຶກໃນເຂດ, ລວມທັງບັນທຶກ NS ສາມຢ່າງ |
| 200 | ສຳເລັດ |
| 403 | API token ຂາດ ຫຼື ບໍ່ຖືກຕ້ອງ, ຫຼື token ບໍ່ມີສິດທີ່ຕ້ອງການ |
ສ້າງເຂດ ແລະ ເຜີຍແຜ່ມັນ. ເຂດເລີ່ມຕົ້ນດ້ວຍບັນທຶກ NS ສາມອັນ ສຳ ລັບ ns1, ns2 ແລະ ns3. vps.org, ເຊິ່ງແມ່ນບັນທຶກລະບົບ ແລະ ບໍ່ສາມາດຈັດການ ຫຼື ຖອນອອກໄດ້.
| ຕົວເລືອກ | ປະເພດ | ຕ້ອງມີການ | ຄໍາອະທິບາຍ |
|---|---|---|---|
domain |
string | ແມ່ນແລ້ວ | ຊື່ໂດເມນ, ຕົວຢ່າງ example. com |
curl -X POST "https://admin.vps.org/api/v1/dns-zones/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"domain": "example.com"}'
{
"uuid": "c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c",
"domain": "example.com",
"created_at": "2026-09-14T21:02:11.402113Z",
"records": [
{
"uuid": "1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b",
"record_type": "NS",
"name": "@",
"value": "ns1.vps.org",
"ttl": 86400,
"priority": null,
"created_at": "2026-09-14"
},
...
],
"record_count": 3
}
| 201 | ເຂດທີ່ໄດ້ສ້າງ |
| 400 | ຊື່ໂດເມນທີ່ບໍ່ຖືກຕ້ອງ |
ສົ່ງຄືນເຂດໜຶ່ງດ້ວຍບັນທຶກທັງໝົດຂອງມັນໃນແຖບບັນທຶກ. ການຕອບຮັບມີຮູບແບບຄືກັນກັບການຕອບຮັບການສ້າງຢູ່ເທິງນີ້.
curl -X GET "https://admin.vps.org/api/v1/dns-zones/c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c/" \
-H "Authorization: Bearer YOUR_API_TOKEN"
| 200 | ສຳເລັດ |
| 404 | ບໍ່ພົບ ຫຼື ມັນເປັນສ່ວນຂອງບັນຊີອື່ນ |
ເອົາເຂດອອກຈາກເຄື່ອງຮັບຊື່ທັງສາມ, ກວດເບິ່ງວ່າບໍ່ມີເຄື່ອງຮັບຊື່ໃດທີ່ຍັງໃຫ້ບໍລິການມັນ, ແລະລຶບເຂດ ແລະບັນທຶກຂອງມັນອອກຈາກນັ້ນ. ຖ້າເຄື່ອງຮັບຊື່ຍັງຕອບຮັບເຂດ, ຄໍາຮ້ອງຂໍຈະລົ້ມເຫລວ ແລະເຂດຈະຖືກຮັກສາໄວ້ ເພື່ອໃຫ້ທ່ານສາມາດພະຍາຍາມອີກຄັ້ງໄດ້.
curl -X DELETE "https://admin.vps.org/api/v1/dns-zones/c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c/" \
-H "Authorization: Bearer YOUR_API_TOKEN"
| 204 | ໄດ້ລຶບອອກແລ້ວ ។ ການຕອບຮັບບໍ່ມີເນື້ອໃນຕົວຈິງ ។ |
| 400 | ຊື່ເຊີບເວີຍັງໃຫ້ບໍລິການເຂດນີ້ຢູ່. ເຂດນີ້ບໍ່ໄດ້ຖືກລຶບ; ລາຍຊື່ຂໍ້ຜິດພາດໃນແຖບລາຍລະອຽດ. |
| 404 | ບໍ່ພົບ ຫຼື ມັນເປັນສ່ວນຂອງບັນຊີອື່ນ |
GET ສົ່ງຄືນບັນທຶກທຸກຢ່າງໃນເຂດເປັນອາຣາມປົກກະຕິ (ບໍ່ໄດ້ຈັດເປັນໜ້າ), ຈັດລຽງຕາມປະເພດ ແລະ ຊື່. POST ເພີ່ມບັນທຶກໄປຍັງເຂດ ແລະ ເຜີຍແຜ່ມັນ.
| ຕົວເລືອກ | ປະເພດ | ຕ້ອງມີການ | ຄໍາອະທິບາຍ |
|---|---|---|---|
record_type |
string | ແມ່ນແລ້ວ | A, AAAA, CNAME, MX, NS, TXT, SRV, PTR, SOA, CAA |
name |
string | ແມ່ນແລ້ວ | @ ສຳລັບໂດເມນເອງ ຫຼື ຊື່ເຊັ່ນ www. ຊື່ຈະຖືກເກັບໄວ້ໃນຕົວອັກສອນນ້ອຍໆ. |
value |
string | ແມ່ນແລ້ວ | ຂໍ້ມູນບັນທຶກ, ຕົວຢ່າງທີ່ຢູ່ IP ຫຼື ຊື່ເຄື່ອງ. ຊື່ເຄື່ອງບໍ່ຕ້ອງການຈຸດຢູ່ເບື້ອງຫຼັງ ແລະ ຄ່າ TXT ບໍ່ຕ້ອງການຕົວອັກສອນຖີ້ມ; ທັງສອງຈະຖືກເພີ່ມເມື່ອບັນທຶກຖືກເຜີຍແຜ່. |
ttl |
integer | ແມ່ນແລ້ວ | ເວລາທີ່ຈະຢູ່ຕໍ່ໄປ ນັບເປັນວິນາທີ |
priority |
integer | ມີແຕ່ MX ແລະ SRV | ຕ້ອງການສຳລັບບັນທຶກ MX ແລະ SRV ແລະ ບໍ່ໄດ້ລະບຸສຳລັບປະເພດອື່ນໆທັງໝົດ. ສຳລັບ SRV, ວາງນໍ້າໜັກ, پورດ ແລະ ຈຸດໝາຍໃນຄ່າ. |
curl -X POST "https://admin.vps.org/api/v1/dns-zones/c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c/records/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"record_type": "MX", "name": "@", "value": "mail.example.com", "ttl": 3600, "priority": 10}'
import requests
zone_uuid = "c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c"
url = f"https://admin.vps.org/api/v1/dns-zones/{zone_uuid}/records/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
data = {"record_type": "A", "name": "www", "value": "203.0.113.10", "ttl": 3600}
response = requests.post(url, headers=headers, json=data)
print(response.status_code, response.json())
{
"uuid": "9d430082-5562-42b4-a0b2-12a6f6c862f9",
"record_type": "MX",
"name": "@",
"value": "mail.example.com",
"ttl": 3600,
"priority": 10,
"created_at": "2026-09-14"
}
| ແຄມເປນ | ປະເພດ | ຄໍາອະທິບາຍ |
|---|---|---|
uuid |
string | ຕົວລະບຸບັນທຶກ, ຖືກໃຊ້ໂດຍ /api/v1/dns-records/ endpoints |
priority |
integer | null | ບູລິມະສິດສຳລັບບັນທຶກ MX ແລະ SRV, ຖ້າບໍ່ດັ່ງນັ້ນ ແມ່ນບໍ່ມີ |
created_at |
date | ພຽງແຕ່ວັນທີ່ສ້າງ (Y- MM- DD), ບໍ່ມີເວລາ |
| 200 | ເອົາມາໃຊ້ຄືນ |
| 201 | POST: ສ້າງບັນທຶກ |
| 400 | ການກວດສອບຄວາມຜິດພາດ, ຕົວຢ່າງ ປະເພດບັນທຶກທີ່ບໍ່ຮູ້, ສູນເສຍ ttl, ຫຼື ບັນທຶກ MX ຫຼື SRV ທີ່ບໍ່ມີຄວາມສຳຄັນ |
| 404 | ບໍ່ພົບ ຫຼື ມັນເປັນສ່ວນຂອງບັນຊີອື່ນ |
ປ່ອຍເຂດ ແລະບັນທຶກທັງໝົດຂອງມັນໄປຍັງເຄື່ອງຮັບຊື່ອີກຄັ້ງ ។ ການປ່ຽນແປງບັນທຶກຈະຖືກເຜີຍແຜ່ໂດຍស្វ័យប្រវត្តិ, ແຕ່ການເຜີຍແຜ່ແມ່ນຄວາມພະຍາຍາມທີ່ດີທີ່ສຸດ ແລະການລົ້ມເຫຼວບໍ່ແມ່ນການລົ້ມເຫຼວຂອງຄໍາຮ້ອງຂໍຕົ້ນຕໍ, ສະນັ້ນໃຊ້ມັນເມື່ອການປ່ຽນແປງບໍ່ປາກົດຢູ່ໃນການຄົ້ນຫາ DNS ។ ບໍ່ມີສ່ວນຂອງຄໍາຮ້ອງຂໍທີ່ຕ້ອງການ ។
curl -X POST "https://admin.vps.org/api/v1/dns-zones/c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c/sync/" \
-H "Authorization: Bearer YOUR_API_TOKEN"
{
"detail": "Zone example.com synced to PowerDNS"
}
GET ສົ່ງຄືນບັນທຶກຂອງເຂດທັງຫມົດຂອງທ່ານ, 25 ຕໍ່ຫນ້າ, ຈັດລຽງຕາມໂດເມນ, ປະເພດແລະຊື່. POST ສ້າງບັນທຶກຄືກັບຈຸດສຸດທ້າຍຂອງບັນທຶກເຂດ, ແຕ່ເອົາເຂດໃນຮ່າງກາຍເປັນ zone_ uuid.
| ຕົວເລືອກ | ປະເພດ | ຕ້ອງມີການ | ຄໍາອະທິບາຍ |
|---|---|---|---|
zone |
string | ບໍ່ | ມີແຕ່ບັນທຶກຂອງເຂດທີ່ມີ uuid ນີ້ |
record_type |
string | ບໍ່ | ບັນທຶກປະເພດນີ້ເທົ່ານັ້ນ, ຕົວຢ່າງ MX (ບໍ່ເໝາະສົມກັບຕົວອັກສອນໃຫຍ່ນ້ອຍ) |
page |
integer | ບໍ່ | ຕົວເລກໜ້າ, ເລີ່ມຈາກ 1 |
curl -X GET "https://admin.vps.org/api/v1/dns-records/?zone=c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c&record_type=A" \
-H "Authorization: Bearer YOUR_API_TOKEN"
curl -X POST "https://admin.vps.org/api/v1/dns-records/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"zone_uuid": "c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c", "record_type": "TXT", "name": "@", "value": "v=spf1 mx -all", "ttl": 3600}'
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"uuid": "4b8e2c10-7d3f-4a5b-9e6c-1a2b3c4d5e6f",
"record_type": "A",
"name": "www",
"value": "203.0.113.10",
"ttl": 3600,
"priority": null,
"created_at": "2026-09-14"
}
]
}
| 200 | ໄດ້ຮັບ: ສໍາເລັດ |
| 201 | POST: ສ້າງບັນທຶກ |
| 400 | ເກີດຂໍ້ຜິດພາດໃນການກວດສອບ, ຫຼື zone_ uuid ຂາດ ຫຼື ບໍ່ແມ່ນເຂດຂອງທ່ານ |
GET ສົ່ງຄືນບັນທຶກຫນຶ່ງ. PUT ແທນທີ່ມັນ ແລະ ຕ້ອງການ record_ type, name, value ແລະ ttl. PATCH ປ່ຽນແປງພຽງແຕ່ພື້ນທີ່ທີ່ທ່ານສົ່ງ. DELETE ເອົາອອກບັນທຶກແລະສົ່ງຄືນ 204 ໂດຍບໍ່ມີຮ່າງກາຍ. ການປ່ຽນແປງແມ່ນເຜີຍແຜ່ທັນທີ. ບັນທຶກ NS ສ້າງຂຶ້ນກັບເຂດແມ່ນບັນທຶກລະບົບ: ປັບປຸງຫຼືລຶບພວກມັນກັບຄືນ 403.
curl -X PATCH "https://admin.vps.org/api/v1/dns-records/4b8e2c10-7d3f-4a5b-9e6c-1a2b3c4d5e6f/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"ttl": 300}'
| 200 | GET, PUT ຫຼື PATCH: ບັນທຶກ |
| 204 | ໄດ້ລຶບອອກແລ້ວ ។ ການຕອບຮັບບໍ່ມີເນື້ອໃນຕົວຈິງ ។ |
| 400 | ຂໍ້ຜິດພາດໃນການផ្ទៀងផ្ទាត់ភាពຖືກຕ້ອງ |
| 403 | ບັນທຶກແມ່ນບັນທຶກລະບົບ ຫຼື ຕົວຊີ້ບອກບໍ່ມີສິດທີ່ຕ້ອງການ |
| 404 | ບໍ່ພົບ ຫຼື ມັນເປັນສ່ວນຂອງບັນຊີອື່ນ |
ຂໍ້ຜິດພາດການກວດສອບໄດ້ກັບຄືນ 400 ດ້ວຍການບອກບັນຫາໂດຍຊື່ແຫລ່ງ:
{
"priority": ["MX records require a priority value"]
}
ຖາມເຊີບເວີຊື່ VPS.org ໂດຍກົງເພື່ອຢືນຢັນການປ່ຽນແປງແມ່ນມີຊີວິດກ່ອນທີ່ການມອບໝາຍຂອງທະບຽນຫຼືການເກັບໄວ້ຂອງຜູ້ແກ້ໄຂຈະຈັບໄດ້:
dig @ns1.vps.org example.com A
dig @ns2.vps.org example.com MX
dig @ns3.vps.org www.example.com