Uxwebhu lwe-VPS.org API

Ndiyaqalisa

I-VPS.org API ikuvumela ukuba ulawule ngokwenkqubo zonke iinkalo zesiseko sakho sokusingatha i-VPS, kuquka iiseva, iidomeni, iirekhodi ze-DNS, ii-backups, kunye nee-snapshots.

Uqinisekiso

Zonke izicelo ze-API zifuna ukuqinisekiswa kusetyenziswa ithokheni ye-Bearer. Ungenza ithokheni yakho ye-API kwizicwangciso zeakhawunti yakho apha 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);

I-token nganye ihambisa iimvume zayo, ezinjengeeseva:uluhlu okanye i-dns: *. Isicelo esifuna iimvume i-token ayinayo silahliwe nge-403 kunye ne-required_permission field enika igama iimvume ezilahlekileyo. Iimvume Zokubhekisa

Ukunciphisa Amaxabiso

Iisicelo eziqinisekisiweyo zimiselwe kwi 1,000 ngeyure ngeakhawunti nganye. Isicelo esingaqinisekiswanga simiselwe kwi 100 ngeyure ngedilesi ye IP. Isicelo esingaphezulu komda sifumana i 429 nge Retry-After header enika inani lemizuzwana yokulindela. Akukho nqanaba lomda wesihloko sithunyelwe kwimpendulo ephumelelayo.

Uhlobo lwegama:

Uluhlu lweendawo eziphezu kokuphela lubuyisela into enobalo, olandelayo, ongaphambili kunye neziphumo, ii-25 izinto kwiphepha ngalinye. Yiya kwiphepha ukushenxisa phakathi kweephepha, okanye landela i-URL elandelayo de ibe yenziwe i-null. Uluhlu lweeseva luya kuthatha i-page_size, ukuya kwi-100.

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

Ukuphatha Impazamo

I-API isebenzisa iikhowudi zesimo se-HTTP eziqhelekileyo ukubonisa impumelelo okanye ukungaphumeleli:

Ikhowudi yeSimo	Inkcazelo
`200`	Impumelelo - Isicelo sigqityiwe ngempumelelo
`201`	Yenziwe - Izixhobo zenziwe ngempumelelo
`400`	Isicelo esibi - Iiparameter ezingavumelekanga okanye isicelo esingalunganga
`202`, `204`	Ivunyiwe kwaye ifolokhwe (202), okanye icima ngaphandle komzimba wophendulelo (204)
`402`	Imali efunekayo: akukho ndlela yokufumana imali kwifayili, iinzala ezingahlawulwanga, okanye ikhadi eligunyazisiweyo eligqityiweyo
`403`	Ithintelwe: i-token ilahlekile, ayisebenzi okanye iphelile, okanye ayinazimvumelwano ezifunekayo. Ubungqina obungalunganga bubuyisela 403, hayi 401.
`404`	Ayifumanekanga - Umthombo awukho
`409`	Conflict: for example a resize already in progress, not enough capacity, or a deployment already running
`429`	Izicelo Ezininzi Kakhulu - Umda wezinga udlulile
`500`	Impazamo Yangaphakathi Yeseva - Kukho into engahambanga kakuhle kwicala lethu
`503`	Inkonzo Ayifumanekanga: ingxaki yexeshana. Zama kwakhona, uhlonipha Retry-After xa ithunyelwe.

Iinkqubo zemposiso ziyi-JSON. Ezininzi zineenkcukacha zomhlaba okanye inkqubo yemposiso yomhlaba, ngamanye amaxesha nomyalezo; iimpazamo zokuqinisekisa zidwelisa iingxaki ngegama lendawo.

Iindidi ze-API

Khangela uxwebhu lwethu lwe-API ngokwezigaba:

I-API yeeSeva 15 Iindawo zokugqibela

Dala, ujonge, usebenzise amandla, uguqule ubungakanani kwaye ususe iiseva, uphinde umisele i-password yomlawuli, umisele i-DNS ejikelezayo, uqhube imimiselo, uphatha izitshixo ze-SSH.

Jonga uxwebhu

I-API yee-Backups 4 Iindawo zokugqibela

Uluhlu lweendawo zokugcina ezikhuselekileyo zeseva yakho, qala indawo yokugcina ekhuselekileyo entsha, kwaye ubuyisele iseva ukusuka kwindawo yokugcina ekhuselekileyo.

Jonga uxwebhu

Iifoto ze-Snapshots API 4 Iindawo zokugqibela

Thatha imifanekiso eqingqiweyo ephawulwe ngegama yomncedisi, uluhlu lwazo uze uzisuse.

Jonga uxwebhu

I-API yeZicwangciso 2 Iindawo zokugqibela

Fumana izicwangciso zeVPS ezikhoyo kunye nolwazi lwamaxabiso. Fumana iinkcukacha malunga nezixhobo, amaxabiso, kunye nokufumaneka kwazo.

Jonga uxwebhu

I-API yeNkqubo zokuSebenza 2 Iindawo zokugqibela

Uluhlu lweenkqubo zokusebenza kunye nohlobo olunokufakwa, ezinjenge-Ubuntu, Debian, Rocky Linux, CentOS Stream, Fedora ne-Alpine.

Jonga uxwebhu

Iindawo ze-API 7 Iindawo zokugqibela

Khangela ukuba zikhona, ubhalisa kwaye uvuselele iinkalo, kwaye umisele iiseva zegama nokuphinda uvuselele ngokuzenzekelayo.

Jonga uxwebhu

I-DNS API 13 Iindawo zokugqibela

Dala i-DNS kunye nokwenza, uhlaziyo kunye nokucima i-A, A, CNAME, MX, TXT, SRV, CAA kunye nezinye iziqulathi zeefayili.

Jonga uxwebhu

I-API yeendawo 2 Iindawo zokugqibela

Iindawo ezifumanekayo zonikezelo lomncedisi.

Jonga uxwebhu

I-akhawunti 1 Iindawo zokugqibela

Fumana inkangeleko ye-akhawunti kunye ne-API token information. Chaza ukuba yeyiphi i-akhawunti i-token ikhoyo kwaye ujonge iimvume zayo.

Jonga uxwebhu

IiNkonzo 7 Iindawo zokugqibela

Ukukhupha i-akhawunti yakho yoqhagamshelana, i-referrals, i-commission kunye ne-payments kwingxelo yakho, utshintshe imimiselo ye-payment kwaye ucele i-payments.

Jonga uxwebhu

Iindawo Ezigqithisileyo

I-API nayo inezinto eziphelelayo zokubekwa kweenkqubo ze-app (/api/v1/deploy-configs/ kunye ne /api/v1/deployments/). Azichazwanga kule phepha; uluhlu loqhagamshelwano oludityanisiweyo lwezinto eziphelelayo, oluvela kwi-API ephilayo.

Vula uluhlu lwezinto ezikhethwayo

Dinga uncedo?

Ukuba unemibuzo okanye ufuna uncedo nge-API, nceda ungathandabuzi ukunxibelelana nathi:

Amatikiti eNkxaso: Vula ithikithi yenkxaso
I-imeyile: hello@vps.org
Uxwebhu: Amaxwebhu apheleleyo