API za planove

Popis serverskih planova koje možete implementirati, sa njihovim resursima i cijenama. Proslijedite uuid plana kao plan_uuid kada stvarate ili mijenjate veličinu servera.

Krajnje tačke 2

Osnovni put /api/v1/plans

DOBITI /api/v1/plans/

Prikaži sve planove

Vraća sve aktivne planove, najjeftinije prvo. Lista nema filtera i trenutno stane na jednu stranicu.

Potrebna dozvola: plans:list

Primjer zahtjeva

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

Primjer odgovora

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

Polja za odgovor

Polje	Tip	Opis
`uuid`	string	Identifikator plana. Koristite ga kao plan_uuid ili new_plan_uuid.
`cpu`	integer	Broj otvora
`ram`, `ram_unit`	integer, string	Količina memorije i njena jedinica (MB ili GB)
`disk_space`	integer	Veličina diska u GB
`disk_space_total`	integer	Veličina diska u MB
`transfer`, `transfer_unit`	integer, string	Mjesečni transfer podataka i njegova jedinica (GB ili TB)
`disk_space_unit`	string	Jedinica disk_prostora (GB)
`includes_ipv4`	boolean	Da li plan uključuje javnu IPv4 adresu. Planovi bez nje su samo IPv6; IPv4 adresa se može dodati za $2.00/mjesečno.
`monthly_price`, `price`	string	Mjesečna cijena u USD kao decimalni niz. cijena je ista vrijednost.
`hourly_price`	string	Satna cijena u USD kao decimalni niz
`cpu_type_name`	string	Tip CPU-a, naprimjer Shared. Ispušta se za planove bez tipa CPU-a, kao što je GPU plan.
`is_active`	boolean	Uvijek istinit u ovoj listi, jer se neaktivni planovi ne vraćaju
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	Da li plan uključuje namjenske GPU-ove, koliko ih je i koji model

Odgovor ne kaže da li plan uključuje IPv4 adresu. Plan od 512 MB je samo IPv6; ostali trenutni planovi uključuju IPv4. Poredajte sa stranicom cijena prije odabira plana za stranicu koja mora biti dostupna preko IPv4.

Kodovi statusa odgovora

200	Uspješno preuzeta lista planova
403	Nedostaje ili nije valjan API token, ili token nema potrebne dozvole

DOBITI /api/v1/plans/{uuid}/

Detalji plana

Vraća jedan aktivni plan sa gornjim poljima. Neaktivni ili nepoznat uuid vraća 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": ""
}