Pepa atoa o le REST API mo le puleaina o 'au'aunaga VPS, 'upega tafa'ilagi, DNS, fa'amaumauga fa'aleoleo, ma isi mea.
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).
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 -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
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.
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": [ ... ]
}
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.
Su'esu'e a matou pepa fa'amaumauga API e tusa ai ma le vaega:
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'amaumaugaFaʻ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'amaumaugaFaʻatonu ata tifaga o se 'au'aunaga, lisi ma faʻamama.
Va'ai i Pepa Fa'amaumaugaToe 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'amaumaugaFaʻ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'amaumaugaFaʻ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'amaumaugaFausia 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'amaumaugaFaʻavasega nofoaga e avanoa mo le faʻaaogaina o le 'auaunaga.
Va'ai i Pepa Fa'amaumaugaToe 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'amaumaugaTosina 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'amaumaugaO 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 fegalegaleaigaAfai 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: