VPS.org API

REST API ҳужжатлаштириш

Operatsion tizimlar APIsi

Ўрнатишингиз мумкин бўлган операцион тизимлар ва уларнинг версияларини рўйхатга олинг. Сервер яратилганда версиянинг uuid'ини operating_system_version_uuid'га ўтказинг.

Tugash nuqtalari 2
Asosiy yo'l /api/v1/operating-systems
OLING /api/v1/operating-systems/

Операцион тизимлар рўйхати

Ҳар бир операцион тизимни унинг фаол версияси билан қайтаради. Ушбу рўйхатда филтрлар йўқ.

Ҳужжат талаб этилади: operating-systems:list

Namunaviy so'rov

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/operating-systems/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

url = "https://admin.vps.org/api/v1/operating-systems/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for os_entry in response.json()["results"]:
    for version in os_entry["versions"]:
        print(os_entry["name"], version["name"], version["uuid"])
const response = await fetch('https://admin.vps.org/api/v1/operating-systems/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
for (const os of data.results) {
  for (const version of os.versions) {
    console.log(os.name, version.name, version.uuid);
  }
}

Javob namunasi

{
  "count": 6,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1,
      "name": "Ubuntu",
      "svg_icon": "<svg ...>",
      "versions": [
        {
          "uuid": "2fdead8f-81a2-4a23-9a81-0cf969fe1266",
          "name": "22.04 LTS x64",
          "os_name": "Ubuntu",
          "os_svg_icon": "<svg ...>",
          "is_active": true
        },
        {
          "uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
          "name": "24.04 LTS x64",
          "os_name": "Ubuntu",
          "os_svg_icon": "<svg ...>",
          "is_active": true
        }
      ]
    }
  ]
}

Қисқартирилган: фақат битта операцион тизим кўрсатилади ва SVG маркировкаси қисқартирилади.

Javob maydonlari

Асосий Turi Тасвирлаш
id integer Операция тизими идентификатори
name string Дистрибутив номи, масалан Ubuntu ёки Debian
svg_icon string Логонинг SVG маркировкаси (URL эмас)
versions array Ўрнатишингиз мумкин бўлган фаол версиялар
versions[].uuid string Сервер яратилганда operating_system_version_uuid сифатида ишлатиш
versions[].name string Версия ва архитектура, масалан 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Она операцион тизимининг номи ва тасвири
versions[].is_active boolean Версия янги серверлар учун ишлатилиши мумкинми ёки йўқми

Javob holati kodlari

200 Муваффақиятли олиб олинган операцион тизимлар рўйхати
403 API токен йўқ ёки нодуруст, ёки токенда талаб қилинган рухсат йўқ
OLING /api/v1/operating-systems/{id}/

Операцион тизимни олиш

Юқоридаги майдонлар билан бир операцион тизим ва унинг фаол версиясини қайтаради.

curl -X GET "https://admin.vps.org/api/v1/operating-systems/1/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Javob holati kodlari

200 Муваффақият
404 Ушбу ID билан операцион тизим йўқ

Версияни танлаш

Уни uuid-ни қаттиқ кодлаш ўрнига, ишга тушиш вақтида версияни ном бўйича қидиринг, шунинг учун сизнинг интеграциянгиз версиялар қўшилган ёки олиб ташланганда ҳам ишлашда давом этади. Сервер тайёр бўлганда root кириш маълумотлари ҳисоб эгасига электрон почта орқали юборилади; сервер яратилганда SSH калитини қўшинг, бунинг ўрнига қулф билан кириш учун.