VPS.org API

Faʻamatalaga o le REST API

VPS.org API Faʻamatalaga

Pepa atoa o le REST API mo le puleaina o 'au'aunaga VPS, 'upega tafa'ilagi, DNS, fa'amaumauga fa'aleoleo, ma isi mea.

URL Autu https://admin.vps.org/api/v1
Fa'amaoniga Fa'ailoga o le Tagata e Avea
Faʻamatalaga v1
Faʻavasega JSON

Amataina

O le VPS.org API e mafai ai ona e pulea fa'apolokalameina vaega uma o lau atina'e talimalo VPS, e aofia ai 'au'aunaga, 'upega tafa'ilagi, fa'amaumauga DNS, fa'amaumauga fa'aleoleo, ma ata pu'e (snapshots).

Fa'amaoniga

O talosaga API uma e manaʻomia le faʻamaoniga e faʻaaoga ai se Bearer token. E mafai ona e faia lau API token mai au faʻatulagaga o tala i le 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);

E i ai ona aia tatau a ia lava i so o se tokeni, pei o servers:list po o dns:*. O se talosaga e manaʻomia ai se aia tatau e le i ai e le tokeni e leʻi taliaina ma le 403 ma se fanua required_permission e taʻua ai le aia tatau e leʻi maua. Faʻamatalaga o aiaiga

Fa'atapula'aina o le fua faatatau

E fa'atapula'aina talosaga fa'amaonia i le 1,000 i le itula mo se teugatupe. E fa'atapula'aina talosaga le fa'amaonia i le 100 i le itula mo se tuatusi IP. O se talosaga i luga o le fa'atapula'aina e maua ai le 429 ma se ulutala Retry-After e tuuina atu ai le aofa'i o sekone e fa'atali ai. E le'i auina atu ni ulutala o le fa'atapula'aina o le fua i tali lelei.

Faʻafanua

O le lisi o le pito i tua e toe faʻafoʻi se mea e aofia ai le numera, mulimuli, muamua ma ni faʻaiuga, 25 mea i le itulau. Faʻasolo le itulau e feʻaveaʻi i le va o itulau, poʻo le mulimuli i le URL mulimuli seʻi vagana ua leiloa. E talia foʻi e le lisi o le'servers' le page_size, e oo atu i le 100.

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

Taulimaina o Mea Sese

E faʻaaogaina e le API tulaga faʻavae o le HTTP e faʻaalia ai le manuia poʻo le toilalo:

Fa'ailoga o le Tulaga Faʻamatalaga
200 Manuia - Ua mae'a lelei le talosaga
201 Fausia - Ua manuia le fausiaina o punaoa
400 Talosaga Leaga - Fa'atulagaga le aoga pe talosaga le sa'o
202, 204 Aoaoga ma le fa'atali (202), po'o le fa'aumaina e aunoa ma se tino tali (204)
402 Faʻatonu: leai se auala totogi i le faila, faʻatauga le totogiina, poʻo se faʻatonu muamua o le pepa na lesitalaina
403 Fa'asaina: e leai se tokeni, e lē talafeagai po'o ua mavae atu, po'o le leai o se aia tatau e mana'omia. O le fa'amaonia e le'i manuia e toe fo'i atu ai le 403, e le 401.
404 E le'i Maua - E leai se punaoa
409 Conflict: mo se faataitaiga o se suiga o le tele ua amataina, e le o lava le avanoa, po o se faapipiiina ua amataina
429 Tele naua Talosaga - Ua sili atu i le tapula'a o le fua faatatau
500 Sese i totonu o le 'Au'aunaga - Sa i ai se mea sese na tupu i la matou itu
503 Auaunaga Le maua: o se faafitauli faafuasei. Toe taumafai, faafetaia le Retry-After pe a auina atu.

O le JSON o le a le mea e tupu ai le faafitauli. E tele ni faafitauli e iai se vaega o faamatalaga po o se vaega o se faafitauli, i nisi taimi ma se imeli; o faafitauli o le faamaoniga e lisiina ai faafitauli e ala i le igoa o le vaega.

Vaega API

Su'esu'e a matou pepa fa'amaumauga API e tusa ai ma le vaega:

API o 'Au'aunaga 15 Fa'ai'uga

Fausia, siaki, malosi, toe faʻaititia ma faʻasaʻo 'au'aunaga, toe faʻaleleia le upu faataga root, seti le DNS faʻasolosolo, faʻatino tulafono, ma pulea ki SSH.

Va'ai i Pepa Fa'amaumauga
API Fa'asao 4 Fa'ai'uga

Faʻavasega au faʻaleoleo o le 'au'aunaga, amata se faʻaleoleo fou, ma toe faʻafoʻi se 'au'aunaga mai se faʻaleoleo.

Va'ai i Pepa Fa'amaumauga
API Ata Pupuu 4 Fa'ai'uga

Faʻatonu ata tifaga o se 'au'aunaga, lisi ma faʻamama.

Va'ai i Pepa Fa'amaumauga
API Fuafuaga 2 Fa'ai'uga

Toe aumai fuafuaga VPS o lo'o avanoa ma fa'amatalaga tau. Maua fa'amatalaga e uiga i punaoa, tau, ma le avanoa.

Va'ai i Pepa Fa'amaumauga
API o Faiga Fa'agaoioia 2 Fa'ai'uga

Faʻavasegaina o faiga faʻagaioiga ma lomiga e mafai ona e faʻapipiʻi, pei o Ubuntu, Debian, Rocky Linux, CentOS Stream, Fedora ma Alpine.

Va'ai i Pepa Fa'amaumauga
Atinaʻe 7 Fa'ai'uga

Faʻamautinoa le avanoa, faʻamaonia ma toe faʻafouina nofoaga, ma faʻatulagaina le igoa o le 'au'aunaga ma le toe faʻafouina otometi.

Va'ai i Pepa Fa'amaumauga
DNS API 13 Fa'ai'uga

Fausia ni nofoaga DNS ma fausia, faʻafouina ma faʻasaʻo a latou A, A, CNAME, MX, TXT, SRV, CAA ma isi faʻamaumauga.

Va'ai i Pepa Fa'amaumauga
API o Nofoaga 2 Fa'ai'uga

Faʻavasega nofoaga e avanoa mo le faʻaaogaina o le 'auaunaga.

Va'ai i Pepa Fa'amaumauga
Faʻamatalaga 1 Fa'ai'uga

Toe maua faʻamatalaga o le faʻamatalaga o le teugatupe ma le API. Faʻailoa le teugatupe e iai se faʻailoga ma siaki ona aia tatau.

Va'ai i Pepa Fa'amaumauga
Faʻatonu 7 Fa'ai'uga

Tosina lau tupe teu affiliate, fautuaga, komisi ma totogi i lau lava lipoti, suia le totogiina o faʻatonu ma talosagaina totogi.

Va'ai i Pepa Fa'amaumauga

E tele atu faʻaiuga

O le API e iai foʻi ni faʻaiuga mo le faʻaaogaina o talosaga (/api/v1/deploy-configs/ ma /api/v1/deployments/). E leʻi faʻamatalaina i luga o nei itulau; o le faʻasinoga fegalegaleai e lisiina uma faʻaiuga, na faia mai i le API ola.

Faʻaola le faʻasinomaga API fegalegaleaiga

Mana'omia se Fesoasoani?

Afai e iai ni au fesili pe manaʻomia se fesoasoani i le API, faʻamolemole aua le faʻatuai e faʻafesoʻotaʻi mai: