API ng mga Plano

Ilista ang mga server plano maaari mong i-deploy, sa kanilang mga mapagkukunan at mga presyo. Magpasa ng isang plano uuid bilang plan_uuid kapag lumikha ka o baguhin ang laki ng isang server.

Mga Endpoint 2

Landas ng Batayan /api/v1/plans

KUMUHA /api/v1/plans/

Ilista ang Lahat ng Plano

Bumalik bawat aktibong plano, cheapest unang. Ang listahan ay walang filter at kasalukuyang fits sa isang pahina.

Kailangang pahintulot: plans:list

Halimbawang Kahilingan

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

Halimbawang Tugon

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

Mga Patlang ng Tugon

Patlang	Uri	Paglalarawan
`uuid`	string	Plano ng identifier. Gamitin ito bilang plan_uuid o bagong_plan_uuid.
`cpu`	integer	Bilang ng mga vCPUs
`ram`, `ram_unit`	integer, string	Memorya halaga at ang yunit nito (MB o GB)
`disk_space`	integer	Disk size sa GB
`disk_space_total`	integer	Disk size sa MB
`transfer`, `transfer_unit`	integer, string	Buwanang allowance sa paglipat ng data at ang yunit nito (GB o TB)
`disk_space_unit`	string	Unit ng disk_space (GB)
`includes_ipv4`	boolean	Kung ang plano ay kasama ang isang pampublikong IPv4 address. Plano na walang isa ay IPv6 lamang; isang IPv4 address ay maaaring idagdag para sa $ 2.00 / buwan.
`monthly_price`, `price`	string	Buwanang presyo sa USD bilang isang decimal string. presyo ay ang parehong halaga.
`hourly_price`	string	Oras presyo sa USD bilang isang decimal string
`cpu_type_name`	string	CPU uri, halimbawa Shared. Omitted para sa mga plano na walang isang uri ng CPU, tulad ng plano GPU.
`is_active`	boolean	Palaging totoo sa listahan na ito, dahil hindi aktibong mga plano ay hindi ibabalik
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	Kung ang plano ay kasama ang mga dedikadong GPUs, kung gaano karaming, at kung aling modelo

Ang 512 MB plan ay IPv6 lamang; ang iba pang mga kasalukuyang mga plano ay kasama ang IPv4. Ihambing sa mga presyo ng pahina bago pumili ng isang plano para sa isang site na dapat ay maaabot sa pamamagitan ng IPv4.

Mga Kodigo ng Katayuan ng Tugon

200	Matagumpay na nakuha plano listahan
403	Walang o hindi wastong API token, o ang token ay kulang ang kinakailangang pahintulot

KUMUHA /api/v1/plans/{uuid}/

Kunin ang mga Detalye ng Plano

Bumalik ng isang aktibong plano sa mga patlang sa itaas. Ang isang hindi aktibo o hindi kilalang uuid bumalik 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": ""
}