Planlar API'si

Kullanabilir sunucu planlarını, kaynakları ve fiyatlarıyla birlikte listele. Bir sunucu yarattığınızda veya yeniden boyutlandırdığınızda plan'ın uuid'ini plan_uuid olarak gönderin.

Uç noktalar 2

Temel Yol /api/v1/plans

ELDE ETMEK /api/v1/plans/

Tüm Planları Listele

En ucuz öncelikle aktif planları geri verir. Listede filtre yok ve şu anda tek bir sayfaya sığmaktadır.

İzin gerekiyor: plans:list

Örnek Talep

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

Örnek Yanıt

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

Yanıt Alanları

Alan	Tip	Açıklama
`uuid`	string	Plan tanımlayıcı. Plan_uuid veya new_plan_uuid olarak kullan.
`cpu`	integer	vCPU sayısı
`ram`, `ram_unit`	integer, string	Bellek miktarı ve birimi (MB veya GB)
`disk_space`	integer	Disk boyutu GB' de
`disk_space_total`	integer	Disk boyutu MB' de
`transfer`, `transfer_unit`	integer, string	Aylık veri transferi kota ve birimi (GB veya TB)
`disk_space_unit`	string	Disk alanının birimi (GB)
`includes_ipv4`	boolean	Planın kamusal IPv4 adresi içerip içermediğini belirtir. Bir adresi olmayan planlar sadece IPv6'dır; ayda $2.00'a IPv4 adresi eklenebilir.
`monthly_price`, `price`	string	Aylık fiyat USD'de ondalık bir dizi olarak. price aynı değerdir.
`hourly_price`	string	Saatlik fiyat dolar olarak ondalık bir dizi olarak
`cpu_type_name`	string	CPU türü, örneğin Paylaşılmış. CPU türü olmayan planlar için, örneğin GPU planı için, bırakılır.
`is_active`	boolean	Bu listede her zaman doğrudur, çünkü etkin olmayan planlar geri döndürülmez
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	Planın özel GPU'lar içerip içermediği, kaç tane ve hangi model

Cevap, planın IPv4 adresi içerip içermediğini söylemez. 512 MB planı sadece IPv6'dır; diğer mevcut planlar IPv4 içerir. IPv4 üzerinden ulaşılabilen bir site için plan seçmeden önce fiyat sayfasıyla karşılaştırınız.

Yanıt Durum Kodları

200	Başarıyla alınan plan listesi
403	Eksik veya geçersiz API token'ı, ya da token'ın gerekli izinleri yok

ELDE ETMEK /api/v1/plans/{uuid}/

Plan Ayrıntılarını Öğrenin

Üstteki alanlarla bir aktif planı geri verir. Etkin olmayan veya bilinmeyen bir uuid 404 geri verir.

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