VPS.org API

Документация

Операциялык системалардын API'си

Орнотула турган операциялык системалардын жана алардын версияларынын тизмесин көрсөтөт. Серверди түзүүдө версиянын uuid-ин operating_system_version_uuid катары өткөрүп берүү керек.

Аяктоо чекиттери 2
Базалык жол /api/v1/operating-systems
АЛУУ /api/v1/operating-systems/

Операциялык системалар тизмеси

Ар бир операциялык системаны анын активдүү версиялары менен кайтарат. Список не имеет фильтров.

Укуктар керек: operating-systems:list

Үлгү суроо-талап

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

Мисал жооп

{
  "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 маркировкасы кыскартылат.

Жооп талаалары

Поле Түрү Сүрөт
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 Версия жаңы серверлер үчүн колдонулушу мүмкүнбү

Жооп берүү статусунун коддору

200 Операциялык системалардын тизмеси ийгиликтүү алынды
403 API-токен жок же жараксыз, же токендин керектүү уруксаты жок
АЛУУ /api/v1/operating-systems/{id}/

Операциялык системаны алуу

Бир операциялык системаны жана анын активдүү версиясын, жогорудагы талаалар менен кайтарат.

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

Жооп берүү статусунун коддору

200 Успешно
404 Мындай идентификатору бар операциялык система жок

Версияны тандоо

Версиялар аты боюнча издөө утилитасы, uuid кодун түзүү ордуна, иштетүү учурунда, ошондуктан сиздин интеграцияңыз версиялар кошулганда же иштен чыгарылганда да иштей берет. Root login details are emailed to the account owner once the server is ready; add a SSH key when creating the server to log in with a key instead.