API Àwọn Ètò Ìṣiṣẹ́

Àtòjọ àwọn sísèmù ìṣàmúlò-ètò tí o lè fi àwọn ìṣàmúlò-ètò wọn pamọ́. Lọ́wọ́lù uuid ìṣàmúlò-ètò bíi ìṣàmúlò-ètò_ìṣàmúlò-ètò_uuid tí o bá kọ́ sáà.

Àwọn ìparí 2

Ipa-ọna Ipilẹ /api/v1/operating-systems

GBÀ /api/v1/operating-systems/

Àtòjọ àwọn ìṣàmúlò-ètò

Fi àwọn síséètì ìṣàmúlò-ètò fún gbogbo wọn pamọ́ nípa àwọn ìṣàmúlò-ètò tí a lò. Àtòjọ náà kò ní àwọn ìṣàmúlò-ètò.

Àwọn ìkúndùǹ tí a fẹ́: operating-systems:list

Àpẹẹrẹ Ìbéèrè

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

Àpẹẹrẹ Ìdáhùn

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

Tí a fi kù: àwọn síséètì ìṣàmúlò-ètò kan ní a fi fihan àti àwọn àmì-ìwé SVG ní a tí kù.

Àwọn Ààyè Ìdáhùn

Àwọn Ààyè-iṣẹ́	Irú	Àwọn Àkọlé
`id`	integer	Àtòjọ-ìṣàmúlò-ètò
`name`	string	Orúkọ ìṣàfihàn, bí àwọn àwọn ààtò Ubuntu tàbí Debian
`svg_icon`	string	Àwọn àmì-ìwé SVG inú àwọn àmì-ìwé (kò jẹ́ URL)
`versions`	array	Àwọn ìṣàmúlò-ètò tí o lè fi pamọ́
`versions[].uuid`	string	Lò ní bíi àwọn ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò_ìṣàmúlò-ètò
`versions[].name`	string	Àwọn ìṣàmúlò-ètò àti ààyè-iṣẹ́, bí àwọn ààyè-iṣẹ́ 24.04 LTS x64
`versions[].os_name`, `versions[].os_svg_icon`	string	Orúkọ àti àwòrán tí a lò fún ìṣàmúlò-ètò alábòójútó
`versions[].is_active`	boolean	Bó àtòjọ-ẹ̀yàn náà lè lo fún àwọn sáà tuntun

Àwọn Kóòdù Ipò Ìdáhùn

200	Àtòjọ àwọn ìṣàmúlò-ètò ìṣàmúlò-ètò tí a tí ìṣàmúlò-ètò náà
403	Tokénà API tí kò bá jẹ́ tàbí tí kò bá jẹ́, tàbí tokénà náà kò ní ìṣẹ̀dà tí a fẹ́

GBÀ /api/v1/operating-systems/{id}/

Gba àwọn ìṣàmúlò-ètò

Fi àwọn ìṣàmúlò-ètò kan pamọ́ nínú àwọn ìṣàmúlò-ètò tí a tí wa ní àwọn ààyè-iṣẹ́ tí a fi ààyè-iṣẹ́ pamọ́.

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

Àwọn Kóòdù Ipò Ìdáhùn

200	Àwọn Ìṣàmúlò-ètò
404	Kò ní ìṣàmúlò-ètò kan tí ID náà

Àwọn ìṣàmúlò-ètò

Look versions up by name at runtime instead of hardcoding a uuid, so your integration keeps working when versions are added or retired. Root login details are emailed to the account owner once the server is ready; add an SSH key when creating the server to log in with a key instead.

VPS.org API

API Àwọn Ètò Ìṣiṣẹ́

Àtòjọ àwọn ìṣàmúlò-ètò

Àpẹẹrẹ Ìbéèrè

Àpẹẹrẹ Ìdáhùn

Àwọn Ààyè Ìdáhùn

Àwọn Kóòdù Ipò Ìdáhùn

Gba àwọn ìṣàmúlò-ètò

Àwọn Kóòdù Ipò Ìdáhùn

Àwọn ìṣàmúlò-ètò