API za planove

Navedite planove servera koje možete raspoređivati, uz njihove resurse i cijene. Dodajte uuid plana kao plan_uuid kada kreirate ili mijenjate veličinu poslužitelja.

Krajnje točke 2

Osnovni put /api/v1/plans

DOBITI /api/v1/plans/

Popis svih planova

Vraća svaki aktivni plan, najjeftinije prvo. Lista nema filtere i trenutno se uklapa 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	Ispišite ga kao plan_uuid ili novi_plan_uid.
`cpu`	integer	Broj vCPU-ova
`ram`, `ram_unit`	integer, string	Količina memorije i njegova 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 dodatak za prijenos podataka i njezina jedinica (GB ili TB)
`disk_space_unit`	string	Jedinica diska (GB)
`includes_ipv4`	boolean	Bilo da plan sadrži javnu IPv4 adresu. Planovi bez njega su samo IPv6; IPv4 adresa može se dodati za 2,00 $/mjesec.
`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, na primjer Shared. Odabran za planove bez procesora tipa, kao što je GPU plan.
`is_active`	boolean	Uvijek ističe u ovom popisu, jer neaktivni planovi nisu vraćeni
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	Bilo da plan uključuje posvećene GPU-ove, koliko, i koji model

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

Kodovi statusa odgovora

200	Popis uspješno dobavljenih planova
403	Nedostaje ili neispravan API žeton, ili token nedostaje potrebna dozvola

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

Detalji plana

Vraća jedan aktivni plan s gornjim poljima. Neaktivan ili nepoznati 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": ""
}