API na Tsare-tsare

Ka yi jerin shirin na'urar mai ba da sabis da za ka iya amfani da su, tare da albarkatunsu da farashinsu. Ka wuce uuid na shirin kamar plan_uuid idan ka yi halitta ko canja girman mai ba da sabis.

Ƙarshen maki 2

Hanyar Tushe /api/v1/plans

SAMU /api/v1/plans/

Jera Duk Shirye-shirye

Returns every active plan, cheapest first. The list has no filters and currently fits on one page.

Required permission: plans:list

Buƙatar Misali

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

Misalin Amsar

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

Wuraren Amsawa

@ action	Nau'i	@ action
`uuid`	string	Mai gane shirin. Yi amfani da shi kamar shirin_uuid ko sabon_shiryen_uuid.
`cpu`	integer	Ma'aikatan
`ram`, `ram_unit`	integer, string	Girman rumbun kwamfutarka da yunitinta (MB ko GB)
`disk_space`	integer	Girman Disk a cikin GB
`disk_space_total`	integer	Girman Disk a MB
`transfer`, `transfer_unit`	integer, string	Matsayin canja wurin bayanai na wata da yunitinsa (GB ko TB)
`disk_space_unit`	string	Unit of disk_space (GB)
`includes_ipv4`	boolean	Ko shirin zai ƙunsa da adireshin IPv4 na jama'a. Shiryoyin da ba su da ɗaya suna da IPv6 kawai; ana iya ƙara adireshin IPv4 don $2.00/mo.
`monthly_price`, `price`	string	Farashin wata a cikin USD kamar wata maƙala ta ɗari. Farashin yana da ma'ana guda.
`hourly_price`	string	Farashin awa a cikin USD kamar wata maɓalli na ɗari
`cpu_type_name`	string	Nau'in CPU, misali Shared. An manta da shi ga shirye-shiryen da ba su da nau'in CPU, kamar shirye-shiryen GPU.
`is_active`	boolean	A ko da yaushe gaskiya a cikin wannan jerin, saboda ba'a mayar da shirye-shiryen da ba'a amfani da su ba
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	Ko shirin na ƙunsa da GPUs masu dacewa, da yawansu, da kuma wane nau'i

Ma'anar ba ta faɗa ko wani shirin ya ƙunsa da adireshin IPv4 ba. Shiri na 512 MB shi ne IPv6 kawai; sauran shirye-shiryen yanzu sun ƙunsa da IPv4. Ka kwatanta da shafin farashin kafin ka zaɓi shirin ga wani shafin da ya kamata a iya isa shi ta hanyar IPv4.

Lambobin Matsayin Amsawa

200	An samu jerin shirye-shiryen da aka samu da nasara
403	An rasa ko kuma an karya tabbacin API, ko kuma tabbacin bai da izinin da ake bukata

SAMU /api/v1/plans/{uuid}/

Nemi Cikakkun Bayanan Tsarin

Returns one active plan with the fields above. An inactive or unknown uuid returns 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": ""
}