VPS.org API

Pagina officialis Documentationis

VPS.org paginarum

Completa documentatio API REST ad administrandos servos VPS, dominia, DNS, copias reservatas, et plura.

URL fundamentalis https://admin.vps.org/api/v1
Authenticatio Tessera Latoris
Versionis v1
Formatus JSON

Initium

API VPS.org tibi permittit ut omnes aspectus infrastructurae hospitii VPS tui programmatice administres, inter quos sunt servitores, dominia, inscriptiones DNS, copiae reservatae, et imagines momentaneas.

Authenticatio

Omnes petitiones API authenticationem per tesseram ferentis requirunt. Tesseram API ex rationis tuae configurationibus generare potes apud admin.vps.org/account/developers/.

cURL
Python
JavaScript
curl -X GET https://admin.vps.org/api/v1/servers/ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

url = "https://admin.vps.org/api/v1/servers/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch('https://admin.vps.org/api/v1/servers/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

Each token carries its own permissions, such as servers:list or dns:*. A request that needs a permission the token does not have is refused with 403 and a required_permission field naming the missing permission. Permissio

Limitatio Frequentiae

Requerimenti authenticati ad 1000 per hora pro contu sunt limitati. Requerimenti non authenticati ad 100 per hora pro IP address sunt limitati. Requerimentum super limitem 429 cum Retry-After capite qui numerum secundorum ad attentionem indicat accepit. Nihil capite limiti velocitatis in responsis successibus mandatur.

Paginae

List endpoints return an object with count, next, previous and results, 25 items per page. Pass page to move between pages, or follow the next URL until it is null. The servers list also accepts page_size, up to 100.

{
  "count": 84,
  "next": "https://admin.vps.org/api/v1/backups/?page=2",
  "previous": null,
  "results": [ ... ]
}

Tractatio Errorum

API utitur codicibus status HTTP consuetis ad indicandum successum vel defectum:

Status Codex Descriptio
200 Successus - Petitio feliciter completa
201 Creatum - Res feliciter creata
400 Petitio Mala - Parametri invalidi vel petitio male formata
202, 204 Accepted and queued (202), or deleted with no response body (204)
402 Nonnullae res in libro non sunt, sed in libro sunt, et nonnullae res in libro non sunt.
403 Prohibitum: token manet, invalidus est, expirat, aut permissio necesse non est. Authenticatio fallita etiam 403, non 401, restituit.
404 Non Inventa - Res non existit
409 Conflictus: exempli gratia, redimensio quae iam in progressu est, non sufficientis capacitatis, vel deployment quae iam in executione est
429 Nimis Multae Petitiones - Finis Frequentiae Superatus
500 Error Internus Servitoris - Aliquid nobis erratum est.
503 Servitius non disponibilis: temporariis problema. Retentare, honorando Retentare-Post cum est mandatum.

Errores in corpus JSON sunt. Plurimae habent campom descriptivum vel campom erroris, aliquando cum message; errores validationis problemata per nomen camporum enumerant.

Categoriae API

Documenta nostra API per categoriam perlustrate:

API Servitorum 15 Extrema

In hoc modo, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse, in bello, ipse

Vide Documentationem
API Copiarum Subsidiariarum 4 Extrema

In hoc modo, servitor in bello, et servitor in pace, in bello et post bello, servit.

Vide Documentationem
API Imaginum Temporalium 4 Extrema

Inscriptio in scripturam antiquam, quae inscriptio et scriptura appellantur, inscriptio et scriptura.

Vide Documentationem
API Consiliorum 2 Extrema

Rationes VPS praesto et informationes de pretiis recupera. Informationes de opibus, pretiis, et disponibilitate accipe.

Vide Documentationem
API Systematum Operativorum 2 Extrema

Systemata operaria et versiones quae installari possunt, sicut Ubuntu, Debian, Rocky Linux, CentOS Stream, Fedora et Alpine, enumerat.

Vide Documentationem
Pagina domestica 7 Extrema

Check availability, register and renew domains, and set nameservers and auto-renewal.

Vide Documentationem
Despectus in Aevum 13 Extrema

In hoc modo, DNS, DNSSEC, et DNSSEC-A, DNSSEC-B, et DNSSEC-C, et DNSSEC-D, et DNSSEC-E, et DNSSEC-F, et DNSSEC-G, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H, et DNSSEC-H.

Vide Documentationem
API Locorum 2 Extrema

Incolae Servienses appellantur.

Vide Documentationem
Continet 1 Extrema

Recupere profilum conti et informationem token API. Identificare cui contu token pertinet et permissiones eius verificare.

Vide Documentationem
Filii 7 Extrema

Pull your affiliate balance, referrals, commissions and payouts into your own reporting, change payout settings and request payouts.

Vide Documentationem

Multae fines

API etiam puncta terminalia pro deploymentibus appibus habet (/api/v1/deploy-configs/ et /api/v1/deployments/). In hoc paginae non sunt descriptae; referentia interretialis omnes puncta terminalia, ex API viva generata, enumerat.

Aperta interretialis API referentia

Opus est auxilio?

Si quaestiones habes vel auxilium de API desideras, noli dubitare quin nos contactes: