API Paket

Menampilkan daftar plan server yang dapat Anda deploy, beserta sumber daya dan harganya. Kirimkan uuid dari sebuah plan sebagai plan_uuid saat Anda membuat atau mengubah ukuran server.

Titik akhir 2

Jalur Dasar /api/v1/plans

MENDAPATKAN /api/v1/plans/

Daftar Semua Paket

Mengembalikan setiap rencana aktif, termurah pertama. Daftar tidak memiliki filter dan kini cocok di satu halaman.

Perlu izin: plans:list

Contoh Permintaan

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

Contoh Jawaban

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

Kolom Respons

Ruas	Jenis	Deskripsi
`uuid`	string	Pengenal plan. Gunakan sebagai plan_uuid atau new_plan_uuid.
`cpu`	integer	Jumlah vCPUS
`ram`, `ram_unit`	integer, string	Jumlah memori dan unitnya (MB atau GB)
`disk_space`	integer	Ukuran disk dalam GB
`disk_space_total`	integer	Ukuran disk dalam MB
`transfer`, `transfer_unit`	integer, string	Uang saku transfer data bulanan dan unitnya (GB atau TB)
`disk_space_unit`	string	Satuan dari disk_space (GB)
`includes_ipv4`	boolean	Apakah rencana ini termasuk alamat IPv4 publik. Rencana tanpa satu adalah IPv6 saja; alamat IPv4 dapat ditambahkan untuk 2.00/bulan.
`monthly_price`, `price`	string	Harga bulanan di USD sebagai string desimal. Harga adalah nilai yang sama.
`hourly_price`	string	Harga per jam di USD sebagai string desimal
`cpu_type_name`	string	Tipe CPU, misalnya Bersama. Diomit untuk rencana tanpa tipe CPU, seperti rencana GPU.
`is_active`	boolean	Selalu benar dalam daftar ini, karena rencana tidak aktif tidak dikembalikan
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	Apakah rencana termasuk GPU yang berdedikasi, berapa banyak, dan model mana

Respons tidak menyebutkan apakah sebuah plan menyertakan alamat IPv4. Plan 512 MB hanya IPv6; plan lain yang aktif saat ini menyertakan IPv4. Bandingkan dengan halaman harga sebelum memilih plan untuk situs yang harus dapat dijangkau melalui IPv4.

Kode Status Respons

200	Berhasil diambil daftar rencana
403	Hilang atau token API tak valid, atau token kurang izin yang diperlukan

MENDAPATKAN /api/v1/plans/{uuid}/

Dapatkan Detail Paket

Mengembalikan satu rencana aktif dengan bidang di atas. Sebuah uuid tidak aktif atau tidak dikenal kembali 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": ""
}