VPS.org API

Documentació de l'API REST

Documentació de l'API de VPS.org

Documentació completa de l'API REST per a la gestió de servidors VPS, dominis, DNS, còpies de seguretat i més.

URL base https://admin.vps.org/api/v1
Autenticació Token del portador
Versió v1.0
Format JSON

Introducció

L'API de VPS.org us permet gestionar programàticament tots els aspectes de la vostra infraestructura d'allotjament VPS, inclosos servidors, dominis, registres DNS, còpies de seguretat i instantànies.

Autenticació

Totes les sol·licituds d'API requereixen autenticació mitjançant un testimoni de portador. Podeu generar el vostre testimoni d'API des de la configuració del vostre compte a 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);

Limitació de velocitat

Les sol·licituds d'API estan limitades a 300 sol·licituds per 5 minuts i per token d'API. La informació sobre el límit de velocitat s'inclou a les capçaleres de resposta:

Gestió d'errors

L'API utilitza codis d'estat HTTP estàndard per indicar l'èxit o el fracàs:

Codi d'estat Descripció
200 Èxit - Sol·licitud completada correctament
201 Creat - Recurs creat correctament
400 Sol·licitud incorrecta: paràmetres no vàlids o sol·licitud amb format incorrecte
401 No autoritzat: testimoni d'autenticació no vàlid o que falta
403 Prohibit - Permisos insuficients
404 No s'ha trobat: el recurs no existeix.
429 Massa sol·licituds: s'ha superat el límit de velocitat
500 Error intern del servidor: alguna cosa ha anat malament per part nostra.

Categories de l'API

Navega per la documentació de la nostra API per categoria:

API de servidors 9 punts finals

Crea, gestiona i controla servidors VPS. Inclou la gestió d'energia, el canvi de mida, la reinstal·lació i la recuperació d'informació del servidor.

Veure documentació
API de còpies de seguretat 3 punts finals

Gestioneu còpies de seguretat automatitzades i manuals per als vostres servidors. Llisteu, creeu, restaureu i suprimiu còpies de seguretat del servidor.

Veure documentació
API de instantànies 4 punts finals

Crea i gestiona instantànies del servidor per a punts de restauració ràpids. Perfecte per a proves i reversions ràpides.

Veure documentació
API de plans 2 punts finals

Recupera informació sobre els plans VPS i els preus disponibles. Obtén detalls sobre recursos, preus i disponibilitat.

Veure documentació
API de sistemes operatius 2 punts finals

Llista de sistemes operatius i imatges disponibles per a la implementació de servidors. Inclou Ubuntu, Debian, CentOS i més.

Veure documentació
API de dominis 6 punts finals

Cerca, comprova la disponibilitat, registra i gestiona noms de domini. Gestió completa del cicle de vida del domini a través de l'API.

Veure documentació
API DNS 4 punts finals

Gestioneu les zones i els registres DNS mitjançant la programació. Creeu, actualitzeu i suprimiu els tipus de registre A, AAAA, CNAME, MX, TXT i altres.

Veure documentació
API d'ubicacions 1 punt final

Llista les ubicacions de centres de dades disponibles per a la implementació de servidors. Trieu entre diverses regions de tot el món.

Veure documentació

Necessites ajuda?

Si teniu preguntes o necessiteu ajuda amb l'API, no dubteu a contactar amb: