Platform

Platform API

The Platform API provides access to platform information and management capabilities for your PoloCloud instance.

Access platform information and available server types

Available Endpoints

List All Platforms

GET /platforms/list

Retrieves a list of all available platforms.

curl -X GET http://localhost:8080/polocloud/api/v3/platforms/list \
  -H "Content-Type: application/json" \
  -b "token=YOUR_TOKEN_HERE"

Response:

{
  "status": 200,
  "data": [
    {
      "name": "paper",
      "type": "SERVER",
      "versions": [
        {
          "version": "1.21.8"
        },
        {
          "version": "1.21.7"
        },
        {
          "version": "1.20.6"
        }
      ]
    },
    {
      "name": "velocity",
      "type": "PROXY",
      "versions": [
        {
          "version": "3.4.0-SNAPSHOT"
        }
      ]
    },
    {
      "name": "waterfall",
      "type": "PROXY",
      "versions": [
        {
          "version": "latest"
        }
      ]
    }
  ]
}

Platform Model

The platform response includes the following structure:

FieldTypeDescription
statusNumberHTTP status code (200)
dataArrayArray of platform objects
data[].nameStringPlatform name (e.g., "paper", "velocity")
data[].typeStringPlatform type ("SERVER" or "PROXY")
data[].versionsArrayAvailable platform versions
data[].versions[].versionStringVersion number or "latest"

Platform Information

Platforms represent different server software types:

SERVER Types:

  • Paper: High-performance Minecraft server
  • Spigot: Vanilla Minecraft server with plugins
  • Fabric: Lightweight modding platform
  • Limbo: Modern Minecraft server
  • and more...

PROXY Types:

  • Velocity: Modern proxy server
  • Waterfall: BungeeCord fork
  • BungeeCord: Original proxy server
  • and more...

Each platform can have multiple versions available for download.