VPS.org API

ເອກະສານ REST API

API ແຜນການ

ລາຍຊື່​ແຜນ​ການ​ຂອງ​ເຄື່ອງ​ແມ່ຂ່າຍ​ທີ່​ທ່ານ​ສາມາດ​ຈັດ​ຕັ້ງ​ໃຊ້​ໄດ້, ພ້ອມ​ດ້ວຍ​ຊັບພະຍາກອນ ແລະ ລາຄາ​ຂອງ​ພວກ​ມັນ. ສົ່ງ uuid ຂອງ​ແຜນ​ການ​ເປັນ plan_uuid ເມື່ອ​ທ່ານ​ສ້າງ ຫຼື ປ່ຽນ​ຂະໜາດ​ຂອງ​ເຄື່ອງ​ແມ່ຂ່າຍ.

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

ລາຍຊື່ແຜນການທັງໝົດ

ສົ່ງຄືນ​ແຜນ​ທີ່​ມີ​ຢູ່​ທຸກ​ຢ່າງ, ລາຄາ​ຖືກ​ທີ່ສຸດ​ກ່ອນ. ລາຍ​ຊື່​ບໍ່​ມີ​ຕົວ​ກັ່ນຕອງ ແລະ ປັດຈຸບັນ​ມັນ​ເໝາະສົມ​ກັບ​ໜ້າ​ດຽວ​ກັນ.

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

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

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

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

response = requests.get(url, headers=headers)
for plan in response.json()["results"]:
    print(plan["uuid"], plan["cpu"], plan["ram"], plan["ram_unit"], plan["monthly_price"])
const response = await fetch('https://admin.vps.org/api/v1/plans/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);
$ch = curl_init('https://admin.vps.org/api/v1/plans/');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_API_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$plans = json_decode(curl_exec($ch), true);
curl_close($ch);

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

{
  "count": 12,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "ed0ac717-c26c-4d9b-a801-b170c4979028",
      "cpu": 1,
      "ram": 512,
      "ram_unit": "MB",
      "disk_space": 10,
      "disk_space_total": 10240,
      "transfer": 500,
      "transfer_unit": "GB",
      "includes_ipv4": false,
      "price": "2.50",
      "cpu_type_name": "Shared",
      "is_active": true,
      "hourly_price": "0.004",
      "monthly_price": "2.50",
      "is_gpu": false,
      "gpu_count": 0,
      "gpu_model": ""
    },
    {
      "uuid": "14186969-fbaf-43e1-9ab2-b1f1aeb66674",
      "cpu": 1,
      "ram": 2,
      "ram_unit": "GB",
      "disk_space": 25,
      "disk_space_total": 25600,
      "transfer": 1,
      "transfer_unit": "TB",
      "includes_ipv4": true,
      "price": "5.00",
      "cpu_type_name": "Shared",
      "is_active": true,
      "hourly_price": "0.007",
      "monthly_price": "5.00",
      "is_gpu": false,
      "gpu_count": 0,
      "gpu_model": ""
    }
  ]
}

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

​ແຄມ​ເປນ ປະເພດ ຄໍາອະທິບາຍ
uuid string ຕົວ​ລະບຸ​ແຜນ​ງານ. ໃຊ້​ມັນ​ເປັນ plan_uuid ຫຼື new_plan_uuid.
cpu integer ຈໍານວນ​ຂອງ​ vCPUs
ram, ram_unit integer, string ຂະໜາດ​ຂອງ​ຄວາມ​ຈຳ ແລະ​ຕົວ​ຈັດ​ອັນ​ດັບ​ຂອງ​ມັນ (MB ຫຼື GB)
disk_space integer ຂະ​ໜາດ​ແຟ້ມ​ໃນ​ GB
disk_space_total integer ຂະ​ໜາດ​ຂອງ​ແຜ່ນ​ເປັນ MB
transfer, transfer_unit integer, string ຄ່າ​ໃຊ້​ຈ່າຍ​ໃນການ​ໂອນ​ຂໍ້ມູນ​ປະຈໍາ​ເດືອນ ແລະ ຕົວ​ເລກ​ຂອງ​ມັນ (GB ຫຼື TB)
disk_space_unit string ໜ່ວຍ​ຂອງ​ພື້ນທີ່​ຮາດ​ດິດ (GB)
includes_ipv4 boolean ວ່າແຜນງານຈະລວມມີທີ່ຢູ່ IPv4 ສາທາລະນະ. ແຜນງານທີ່ບໍ່ມີແມ່ນ IPv6 ເທົ່ານັ້ນ; ທີ່ຢູ່ IPv4 ສາມາດເພີ່ມໄດ້ ສຳ ລັບ $2.00 / ເດືອນ.
monthly_price, price string ລາຄາເດືອນໃນ USD ເປັນ string ຕົວເລກຮ້ອຍ. ລາຄາແມ່ນຄ່າດຽວກັນ.
hourly_price string ລາຄາ​ຕໍ່​ຊົ່ວໂມງ​ໃນ USD ເປັນ​ຂໍ້​ຄວາມ​ຮ້ອຍ
cpu_type_name string ປະເພດ CPU, ຕົວຢ່າງ ແບ່ງປັນ. ຍົກເວັ້ນສຳລັບແຜນທີ່ບໍ່ມີປະເພດ CPU, ເຊັ່ນ ແຜນ GPU.
is_active boolean ຖືກ​ຕ້ອງ​ເປັນ​ປະຈຳ​ໃນ​ລາຍການ​ນີ້, ຍ້ອນ​ວ່າ​ແຜນ​ທີ່​ບໍ່​ມີ​ການ​ເຮັດ​ໃຫ້​ມີ​ການ​ກັບ​ຄືນ​ມາ
is_gpu, gpu_count, gpu_model boolean, integer, string ວ່າ​ແຜນ​ຈະ​ລວມ​ເອົາ GPUs ທີ່​ໄດ້​ຮັບ​ການ​ມອບໝາຍ, ຈຳນວນ ແລະ ແບບໃດ
ການຕອບສະຫນອງບໍ່ໄດ້ບອກວ່າຖ້າຫາກວ່າແຜນປະກອບມີທີ່ຢູ່ IPv4. ແຜນ 512 MB ແມ່ນ IPv6 ເທົ່ານັ້ນ; ແຜນອື່ນໆໃນປັດຈຸບັນປະກອບມີ IPv4. ທຽບກັບຫນ້າລາຄາກ່ອນທີ່ຈະເລືອກເອົາແຜນສໍາລັບເວັບໄຊທີ່ຕ້ອງສາມາດເຂົ້າເຖິງໄດ້ຜ່ານ IPv4.

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

200 ລາຍຊື່​ແຜນທີ່​ໄດ້​ຮັບ​ຜົນ​ສຳເລັດ
403 API token ຂາດ ຫຼື ບໍ່ຖືກຕ້ອງ, ຫຼື token ບໍ່ມີສິດທີ່ຕ້ອງການ
ຮັບ /api/v1/plans/{uuid}/

ຮັບລາຍລະອຽດແຜນການ

ສົ່ງຄືນ​ແຜນ​ທີ່​ມີ​ການ​ເຄື່ອນ​ໄຫວ​ກັບ​ແຫລ່ງ​ຂໍ້ມູນ​ຂ້າງ​ເທິງ​ນີ້. ບໍ່ມີ​ການ​ເຄື່ອນ​ໄຫວ ຫຼື ບໍ່ຮູ້ uuid ສົ່ງຄືນ 404.

curl -X GET "https://admin.vps.org/api/v1/plans/ed0ac717-c26c-4d9b-a801-b170c4979028/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "uuid": "ed0ac717-c26c-4d9b-a801-b170c4979028",
  "cpu": 1,
  "ram": 512,
  "ram_unit": "MB",
  "disk_space": 10,
  "disk_space_total": 10240,
  "transfer": 500,
  "transfer_unit": "GB",
  "includes_ipv4": false,
  "price": "2.50",
  "cpu_type_name": "Shared",
  "is_active": true,
  "hourly_price": "0.004",
  "monthly_price": "2.50",
  "is_gpu": false,
  "gpu_count": 0,
  "gpu_model": ""
}