VPS.org API

ເອກະສານ REST API

ໂດເມນ

ຄົ້ນຫາ​ຊື່​ໂດເມນ​ທີ່​ມີ, ລົງທະບຽນ ແລະ ປັບປຸງ​ໂດເມນ, ແລະ ຈັດການ​ຊື່​ເຊີບເວີ ແລະ ປັບປຸງ​ອັດຕະໂນມັດ. ໂດເມນ​ແມ່ນ​ຖືກ​ລະບຸ​ໂດຍ uuid ຂອງ​ພວກ​ມັນ.

ຈຸດສິ້ນສຸດ 7
ເສັ້ນທາງພື້ນຖານ /api/v1/domains
ຮັບ /api/v1/domains/

ລາຍຊື່ໂດເມນທັງໝົດ

ສົ່ງ​ຄືນ​ໂດເມນ​ທີ່​ໄດ້​ລົງທະບຽນ​ໃນ​ບັນຊີ​ຂອງທ່ານ, 25 ຕໍ່​ໜ້າ. ລາຍຊື່​ບໍ່​ມີ​ຕົວ​ກັ່ນຕອງ​ຫຍັງ​ເລີຍ.

ຕ້ອງການ​ສິດ​ອຳນາດ: domains:list

ຕົວຢ່າງການຮ້ອງຂໍ

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for domain in response.json()["results"]:
    print(domain["domain_name"], domain["status"], domain["expiration_date"])
const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

ຕົວຢ່າງການຕອບສະໜອງ

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
      "domain_name": "example.com",
      "status": "active",
      "registrar": "dynadot",
      "registration_date": "2026-01-15T10:30:00Z",
      "expiration_date": "2027-01-15T10:30:00Z",
      "days_until_expiration": 122,
      "is_expired": false,
      "needs_renewal_soon": false,
      "auto_renew": true,
      "renewal_period_years": 1,
      "registration_price": "12.64",
      "renewal_price": "12.64",
      "whois_privacy": true,
      "nameserver1": "ns1.vps.org",
      "nameserver2": "ns2.vps.org",
      "nameserver3": "ns3.vps.org",
      "nameserver4": null,
      "transfer_lock": true,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-09-01T08:12:40Z"
    }
  ]
}

ພາກສະໜາມຕອບສະໜອງ

​ແຄມ​ເປນ ປະເພດ ຄໍາອະທິບາຍ
uuid string ຕົວ​ລະບຸ​ໂດເມນ​ທີ່​ໃຊ້​ໃນ​ຈຸດ​ຈົບ​ໂດເມນ​ອື່ນ
status string active, pending, expired, cancelled, transferred
registrar string ທະບຽນ​ໂດເມນ​ທີ່​ມີ​ຢູ່​ທີ່
registration_date, expiration_date datetime ເມື່ອ​ໂດເມນ​ຖືກ​ລົງທະບຽນ ແລະ ເມື່ອ​ມັນ​ໝົດ​ອາຍຸ. expiration_ date ສາມາດ​ເປັນ​ລົບ.
days_until_expiration integer | null ມື້​ເຕັມ​ຈົນ​ເຖິງ expiration_ date, ຜົນບວກ​ເມື່ອ​ໝົດ​ກຳນົດ
is_expired, needs_renewal_soon boolean ວ່າ​ໂດເມນ​ໄດ້​ໝົດ​ອາຍຸ​ແລ້ວ ຫຼື ບໍ່ ແລະ ວ່າ​ຈະ​ໝົດ​ອາຍຸ​ໃນ​ 30 ວັນ​ຕໍ່​ໄປ ຫຼື ບໍ່
auto_renew, renewal_period_years boolean, integer ວ່າ​ໂດເມນ​ຈະ​ເຮັດ​ໃຫ້​ມີ​ການ​ປັບ​ໃໝ່​ໂດຍ​ອັດຕະໂນມັດ ແລະ ວ່າ​ຈະ​ໃຊ້​ໄດ້​ດົນ​ປານໃດ
registration_price, renewal_price string ລາຄາ​ໃນ USD ເປັນ​ຂໍ້​ຄວາມ​ຮ້ອຍ
whois_privacy, transfer_lock boolean WHOIS ຄວາມເປັນສ່ວນຕົວ ແລະ ການຕັ້ງຄ່າການລັອກການໂອນ
nameserver1 to nameserver4 string | null ម៉ាស៊ីន​ບອກ​ຊື່​ຂອງ​ໂດເມນ
created_at, updated_at datetime ເມື່ອ​ບັນທຶກ​ຖືກ​ສ້າງ​ຂຶ້ນ ແລະ ປ່ຽນແປງ​ຄັ້ງ​ສຸດ​ທ້າຍ (ISO 8601, UTC)
ຮັບ /api/v1/domains/{uuid}/

ເອົາ​ລາຍລະອຽດ​ຂອງ​ໂດເມນ

ສົ່ງ​ຄືນ​ສິ່ງ​ໂດເມນ​ດຽວ​ກັບ​ແຫລ່ງ​ຂໍ້ມູນ​ຂ້າງ​ເທິງ

ຕ້ອງການ​ສິດ​ອຳນາດ: domains:list

curl -X GET "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

ລະຫັດສະຖານະການຕອບສະໜອງ

200 ສຳເລັດ
404 ບໍ່ພົບ ຫຼື ມັນເປັນສ່ວນຂອງບັນຊີອື່ນ
ສົ່ງ /api/v1/domains/search/

ຄົ້ນຫາ​ໂດເມນ​ທີ່​ມີ​ຢູ່

ກວດເບິ່ງວ່າ​ຊື່​ມີ​ຢູ່​ໃນ​ສ່ວນ​ຂະຫຍາຍ​ທີ່​ນິຍົມ​ປະມານ 20 ອັນ (com, net, org, io, dev, co, app, ai ແລະ​ອື່ນໆ), ພ້ອມ​ທັງ​ສ່ວນ​ຂະຫຍາຍ​ທີ່​ທ່ານ​ໄດ້​ພິມ​ໄວ້ ຖ້າ​ມັນ​ບໍ່​ຢູ່​ໃນ​ນັ້ນ ។ ຜົນ​ໄດ້ຮັບ​ເລີ່ມ​ຕົ້ນ​ດ້ວຍ​ການ​ກົງ​ກັນ​ຢ່າງ​ແທ້ຈິງ, ຫຼັງຈາກ​ນັ້ນ​ຊື່​ທີ່​ມີ, ຫຼັງຈາກ​ນັ້ນ​ຊື່​ທີ່​ໄດ້​ຮັບ ។

ຕ້ອງການ​ສິດ​ອຳນາດ: domains:search

ຮ້ອງຂໍພາລາມິເຕີຂອງຮ່າງກາຍ

ຕົວ​ເລືອກ​ ປະເພດ ຕ້ອງມີການ ຄໍາອະທິບາຍ
domain string ແມ່ນແລ້ວ ຊື່​ທີ່​ມີ ຫຼື ບໍ່ມີ​ສ່ວນ​ເພີ່ມ, ຕົວຢ່າງ mysite ຫຼື mysite. com (2 ເຖິງ 63 ຕົວອັກສອນ)

ຕົວຢ່າງການຮ້ອງຂໍ

cURL
Python
curl -X POST "https://admin.vps.org/api/v1/domains/search/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.com"}'
import requests

url = "https://admin.vps.org/api/v1/domains/search/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.post(url, headers=headers, json={"domain": "mysite.com"})
for result in response.json()["results"]:
    if result["available"]:
        print(result["domain"], result["registration_price"], result["renewal_price"])

ຕົວຢ່າງການຕອບສະໜອງ

{
  "results": [
    {
      "domain": "mysite.com",
      "available": false,
      "price": null,
      "registration_price": null,
      "renewal_price": null,
      "tld": "com",
      "is_exact_match": true
    },
    {
      "domain": "mysite.dev",
      "available": true,
      "price": 17.24,
      "registration_price": 17.24,
      "renewal_price": 17.24,
      "tld": "dev",
      "is_exact_match": false
    }
  ],
  "base_domain": "mysite",
  "search_count": 20
}

ລາຄາແມ່ນຕົວເລກໃນ USD ສໍາລັບຫນຶ່ງປີແລະແມ່ນ null ສໍາລັບຊື່ທີ່ບໍ່ມີ. ລາຄາທີ່ສະແດງແມ່ນສະແດງໃຫ້ເຫັນ.

ລະຫັດສະຖານະການຕອບສະໜອງ

200 ສຳເລັດ
400 ຂາດ​ໂດເມນ ຫຼື ມີ​ຕົວອັກສອນ​ອື່ນ​ນອກ​ຈາກ​ຕົວອັກສອນ, ຕົວເລກ ແລະ ສັນຍາລັກ​ຮອບ​ຄອບ
500 ການ​ຄົ້ນຫາ​ທະບຽນ​ໄດ້​ລົ້ມເຫລວ ។ ພະຍາຍາມ​ອີກ​ຄັ້ງ​ຫຼັງ​ຈາກ​ນີ້ ។
ສົ່ງ /api/v1/domains/register/

ລົງທະບຽນໂດເມນໃໝ່

ລົງທະບຽນໂດເມນແລະ charges ວິທີການຈ່າຍເງິນທີ່ເກັບໄວ້ຂອງທ່ານ. ຄວາມເປັນໄປໄດ້ແລະລາຄາແມ່ນກວດສອບກັບຜູ້ລົງທະບຽນອີກເທື່ອຫນຶ່ງກ່ອນທີ່ຄ່າໃຊ້ຈ່າຍ. ລາຍລະອຽດຕິດຕໍ່ຜູ້ລົງທະບຽນແມ່ນໄດ້ມາຈາກໂປຼໄຟລ໌ບັນຊີຂອງທ່ານ. ຖ້າຫາກວ່າຜູ້ລົງທະບຽນປະຕິເສດການລົງທະບຽນຫຼັງຈາກຄ່າໃຊ້ຈ່າຍ, ການຈ່າຍເງິນແມ່ນຖືກສົ່ງຄືນ.

ຕ້ອງການ​ສິດ​ອຳນາດ: domains:register (ໄດ້​ຮັບ​ການ​ອະນຸຍາດ​ໂດຍ​ໂດເມນ: *)

ຮ້ອງຂໍພາລາມິເຕີຂອງຮ່າງກາຍ

ຕົວ​ເລືອກ​ ປະເພດ ຕ້ອງມີການ ຄໍາອະທິບາຍ
domain string ແມ່ນແລ້ວ ຊື່​ໂດເມນ​ເຕັມ ລວມທັງ​ສ່ວນ​ເພີ່ມ​ຂອງ​ມັນ, ຕົວຢ່າງ example. com
years integer ​ບໍ່ ໄລຍະເວລາການລົງທະບຽນ, 1 ເຖິງ 10 (ປັ໊ມ 1). ລາຄາແມ່ນລາຄາປະຈໍາປີຄັ້ງປີ..ai ຕ້ອງການຢ່າງຫນ້ອຍ2ປີ; ຄ່າທີ່ນ້ອຍກວ່າກັບຄືນ 400. 
curl -X POST "https://admin.vps.org/api/v1/domains/register/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.dev", "years": 1}'

ຕົວຢ່າງການຕອບສະໜອງ

{
  "success": true,
  "domain_uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
  "domain_name": "mysite.dev",
  "message": "mysite.dev registered successfully!"
}

ລະຫັດສະຖານະການຕອບສະໜອງ

201 ໂດເມນ​ທີ່​ໄດ້​ລົງທະບຽນ
400 ໂດເມນບໍ່ຖືກຕ້ອງ, ໂດເມນບໍ່​ມີ​ຢູ່​ອີກ​ຕໍ່​ໄປ, ລາຄາ​ບໍ່​ສາມາດ​ກວດ​ສອບ​ໄດ້, ວິທີການ​ຈ່າຍ​ເງິນ​ທີ່​ບໍ່​ທັນ​ສະໄໝ, ຫຼື ການ​ຈ່າຍ​ເງິນ​ລົ້ມເຫລວ
402 ບໍ່ມີ​ວິທີ​ຈ່າຍ​ໃນ​ໄຟລ໌ ຫຼື ໃບ​ເກັບ​ເງິນ​ທີ່​ບໍ່​ໄດ້​ຈ່າຍ
500 ການຈ່າຍເງິນບໍ່ສາມາດຖືກປະຕິບັດ, ຫຼືຜູ້ລົງທະບຽນໄດ້ປະຕິເສດການລົງທະບຽນຫຼັງຈາກການຈ່າຍເງິນ. ໃນກໍລະນີທີສອງຂໍ້ຄວາມຜິດພາດເວົ້າວ່າຖ້າການຈ່າຍຄືນໄດ້ຜ່ານ.
ສົ່ງ /api/v1/domains/{uuid}/renew/

ປ່ຽນ​ໂດເມນ

ປັບປຸງ​ໂດເມນ ແລະ ຄິດຄ່າໃຊ້ຈ່າຍ​ຄ່າ​ທົດ​ແທນ​ຂອງ​ມັນ​ທຸກໆ​ປີ​ເພື່ອ​ວິທີການ​ຈ່າຍ​ເງິນ​ທີ່​ໄດ້​ເກັບ​ໄວ້​ຂອງທ່ານ.

ຕ້ອງການ​ສິດ​ອຳນາດ: domains:renew

ຮ້ອງຂໍພາລາມິເຕີຂອງຮ່າງກາຍ

ຕົວ​ເລືອກ​ ປະເພດ ຕ້ອງມີການ ຄໍາອະທິບາຍ
years integer ​ບໍ່ ປີ​ທີ່​ຈະ​ເພີ່ມ, 1 ເຖິງ 10 (ຕົວ​ແບບ​ເດີມ 1) 
curl -X POST "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/renew/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"years": 1}'
{
  "success": true,
  "domain_uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
  "new_expiration": "2028-01-15T10:30:00+00:00",
  "message": "example.com renewed successfully for 1 year(s)!"
}

ລະຫັດສະຖານະການຕອບສະໜອງ

200 ໂດເມນ​ໄດ້​ຖືກ​ປັບປຸງ​ໃໝ່
400 ປີ​ທີ່​ບໍ່​ຖືກຕ້ອງ, ບໍ່ມີ​ລາຄາ​ເພີ່ມ​ໃໝ່​ສຳລັບ​ໂດເມນ, ບໍ່ມີ​ວິທີ​ການ​ຈ່າຍ​ເງິນ​ທີ່​ໃຊ້​ໄດ້ ຫຼື ການ​ຈ່າຍ​ເງິນ​ລົ້ມເຫລວ
404 ບໍ່ພົບ ຫຼື ມັນເປັນສ່ວນຂອງບັນຊີອື່ນ
500 ການຈ່າຍເງິນບໍ່ສາມາດຖືກປະຕິບັດ, ຫຼືການຈ່າຍເງິນໄດ້ຜ່ານໄປແຕ່ການຍົກລະດັບຂອງທະນາຍຄວາມໄດ້ລົ້ມເຫລວ. ຕິດຕໍ່ສະຫນັບສະຫນູນໃນກໍລະນີນັ້ນ.
PUT /api/v1/domains/{uuid}/nameservers/

ປັບປຸງ​ម៉ាស៊ីន​បម្រើ​ຊື່

ຕັ້ງຄ່າຊື່ຂອງໂດເມນຂອງເຄື່ອງແມ່ຂ່າຍທີ່ທະບຽນແລະກັບຄືນໄປບ່ອນທີ່ປັບປຸງໂດເມນຂອງສິ່ງ. ເພື່ອຄຸ້ມຄອງ DNS ກັບ DNS API, ນໍາໃຊ້ ns1.vps.org, ns2.vps.org ແລະ ns3.vps.org ແລະສ້າງເຂດສໍາລັບໂດເມນ.

ຕ້ອງການ​ສິດ​ອຳນາດ: domains:update

ຮ້ອງຂໍພາລາມິເຕີຂອງຮ່າງກາຍ

ຕົວ​ເລືອກ​ ປະເພດ ຕ້ອງມີການ ຄໍາອະທິບາຍ
nameserver1 string ແມ່ນແລ້ວ ຊື່​ម៉ាស៊ីន​បម្រើ​ຊື່​ຕົ້ນຕໍ
nameserver2, nameserver3, nameserver4 string ​ບໍ່ ຊື່​ម៉ាស៊ីន​ບອກ​ຊື່​ເພີ່ມ 
curl -X PUT "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/nameservers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"nameserver1": "ns1.vps.org", "nameserver2": "ns2.vps.org", "nameserver3": "ns3.vps.org"}'

ລະຫັດສະຖານະການຕອບສະໜອງ

200 ຊື່​ເຊີບເວີ​ໄດ້​ປັບປຸງ; ຮ່າງກາຍ​ແມ່ນ​ສິ່ງ​ຂອງ​ໂດເມນ
400 បាត់​ម៉ាស៊ីន​បម្រើ​ຊື່​1
404 ບໍ່ພົບ ຫຼື ມັນເປັນສ່ວນຂອງບັນຊີອື່ນ
500 ການ​ອັບເດດ​ລົ້ມເຫລວ; ທ້ອງ​ມີ​ຂໍ້ຜິດພາດ ແລະ ພື້ນທີ່​ຂໍ້ຄວາມ
PUT /api/v1/domains/{uuid}/auto-renew/

ເປີດ/ ປິດ​ການ​ຟື້ນ​ຟູ​ອັດຕະໂນມັດ

ຕັ້ງຄ່າ auto_renew ແລະ ສົ່ງ​ຄືນ​ສິ່ງ​ທີ່​ດາວ​ໂດເມນ​ໄດ້​ປັບປຸງ​ໃໝ່. ສົ່ງ​ເປັນ JSON boolean: ສາຍ​ຂໍ້​ໃດ​ໜຶ່ງ​ທີ່​ບໍ່​ວ່າງ, ລວມທັງ​ສາຍ​ຂໍ້ false, ເປີດ​ການ​ດາວໂຫລດ​ອັດຕະໂນມັດ.

ຕ້ອງການ​ສິດ​ອຳນາດ: domains:update

curl -X PUT "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/auto-renew/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

ລະຫັດສະຖານະການຕອບສະໜອງ

200 ບັນທຶກ​ການ​ຕັ້ງຄ່າ; ທ້ອງ​ແມ່ນ​ສິ່ງ​ຂອງ​ໂດເມນ
400 ​ໄດ້​ເປີດ​ແລ້ວ​បាត់
404 ບໍ່ພົບ ຫຼື ມັນເປັນສ່ວນຂອງບັນຊີອື່ນ

ບັນທຶກ