API ya Mipango

Orodhesha mipango ya uwekezaji unayoweza kutumia, kwa kutumia rasilimali na bei zao. Packe uiid's planid kama_uuid unapotengeneza au kutengeneza upya kampuni ya kutengenezea huduma.

Sehemu za Mwisho 2

Njia ya Msingi /api/v1/plans

PATA /api/v1/plans/

Orodhesha Mipango Yote

Orodha hiyo inarudia kila mpango, na haigharimu pesa nyingi.

Ruhusa ya Kuruhusiwa: plans:list

Ombi la Mfano

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

Jibu la Mfano

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

Sehemu za Majibu

Field	Aina	Maelezo
`uuid`	string	Itumie kama plani_uid au mpya_plan_uid.
`cpu`	integer	Idadi ya vCPUs
`ram`, `ram_unit`	integer, string	Kiasi cha kumbukumbu na kipimo chalo (MB au GB)
`disk_space`	integer	Ukubwa usiopendeza katika GB
`disk_space_total`	integer	Ukubwa usiopendeza katika MB
`transfer`, `transfer_unit`	integer, string	Mwezi unatuma habari na kizio chake (GB au TB)
`disk_space_unit`	string	Sehemu ya diski_space (GB)
`includes_ipv4`	boolean	Whether the plan includes a public IPv4 address. Plans without one are IPv6 only; an IPv4 address can be added for $2.00/month.
`monthly_price`, `price`	string	Bei ya kila mwezi katika dola ya Marekani kama uzi wa desimali. bei ni ile ile.
`hourly_price`	string	Gharama ya dola za Marekani kwa muda mrefu kama uzi wa desimali
`cpu_type_name`	string	Kwa mfano, picha ya CPU, ilikubaliwa kwa ajili ya mipango isiyo na alama ya CPU, kama vile mpango wa GPU.
`is_active`	boolean	Ni kweli sikuzote katika orodha hii, kwa sababu mipango isiyo na utendaji hairudi
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	Iwe mpango huo unatia ndani GPUs, watu wangapi, na watu wa aina gani waliojiweka wakfu

Jibu halisemi kama mpango unatia ndani anwani ya IPv4. Mpango wa 512 MB ni IPv6 pekee; ramani ile nyingine ya sasa ni pamoja na IPv4. Linganisha na ukurasa wa kwanza kabla ya kuchagua mpango wa tovuti ambayo lazima ifikishwe juu ya IPv4.

Misimbo ya Hali ya Majibu

200	Orodha ya mipango iliyofanikiwa
403	Ishara hiyo ikikosekana au yenye kasoro, au ile ishara haina ruhusa inayohitajiwa

PATA /api/v1/plans/{uuid}/

Pata Maelezo ya Mpango

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