VPS.org API

Documentación de API REST

API de sistemas operativos

Lista los sistemas operativos que puedes instalar y sus versiones. Pasa la versión de uuid como operativo_system_version_uuid cuando crees un servidor.

Puntos finales 2
Ruta base /api/v1/operating-systems
CONSEGUIR /api/v1/operating-systems/

Listar sistemas operativos

Devuelve cada sistema operativo con sus versiones activas. La lista no tiene filtros.

Permiso requerido: operating-systems:list

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Acortado: sólo se muestra un sistema operativo y se corta el marcado SVG.

Campos de respuesta

Campo Tipo Descripción
id integer Identificador del sistema operativo
name string Nombre de distribución, por ejemplo Ubuntu o Debian
svg_icon string Marcado SVG en línea del logotipo (no una URL)
versions array Versiones activas que puede instalar
versions[].uuid string Usar como operativo_sistema_versión_uuid al crear un servidor
versions[].name string Versión y arquitectura, por ejemplo 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Nombre e icono del sistema operativo padre
versions[].is_active boolean Si la versión puede ser utilizada para nuevos servidores

Códigos de estado de respuesta

200 Lista de sistemas operativos recuperados con éxito
403 Token API no válido o falta el token o el token carece del permiso requerido
CONSEGUIR /api/v1/operating-systems/{id}/

Obtenga un sistema operativo

Devuelve un sistema operativo y sus versiones activas, con los campos anteriores.

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

Códigos de estado de respuesta

200 Éxito
404 No hay sistema operativo con ese id

Elegir una versión

Busque versiones por nombre en tiempo de ejecución en lugar de codificar un uuid, por lo que su integración sigue funcionando cuando se agregan versiones o se retira. Los detalles de inicio de sesión en raíz se envían por correo electrónico al propietario de la cuenta una vez que el servidor esté listo; agregue una tecla SSH cuando cree el servidor para iniciar sesión con una clave en su lugar.