VPS.org Litokomane tsa API

Rea qala

VPS.org API e o dumella ho laola ka lenaneo dikarolo tsohle tsa meralo ya motheo ya hao ya ho amohela VPS, ho kenyeletswa le di-server, di-domain, direkoto tsa DNS, di-backup le di-snapshots.

Netefatso

Likopo tsohle tsa API li hloka netefatso ho sebelisoa token ea Bearer. U ka hlahisa token ea hau ea API ho tsoa litlhophisong tsa akhaonto ea hau ho 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);

Token e ngoe le e ngoe e na le litokelo tsa eona, joalo ka servers:list kapa dns:*. Lipotso tse hlokang litokelo tseo token e sa li nang le tsona li refuted ka 403 le sebaka sa required_permission se bitsoang litokelo tse sa fumaneheng. Litokelo

Tekanyetso ea Sekhahla

Lipotso tse sa tsejoeng li lekanyelitsoe ho 1000 ka hora ka akhaonto. Lipotso tse sa tsejoeng li lekanyelitsoe ho 100 ka hora ka aterese ea IP. Lipotso tse feta tekanyetso li tla fumana 429 le lebokose le reng Retry-After le fanang ka palo ea metsotsoana e tla etsoa. Ha ho na lebokose le reng rate limit le tla romelloa ka likarabo tse atlehileng.

Ho theha leqephe

Li-endpoints tsa lenane li khutlisa ntho e nang le palo, e latelang, e fetileng le litlamorao, lintho tse 25 ka leqephe. Emisa leqephe ho tsamaea lipakeng tsa lihlooho, kapa latela URL e latelang ho fihlela e le null. Lenaneo la liservers le amohela page_size, ho fihlela ho 100.

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

Phoso ea ho sebetsana le eona

API e sebelisa likhoutu tse tloaelehileng tsa boemo ba HTTP ho bontša katleho kapa ho hloleha:

Li-body tsa liphoso ke JSON. Ho na le libaka tse ngata tsa lintlha kapa libaka tsa liphoso, ka linako tse ling le lengolo-tsoibila; liphoso tsa ho nepahala li bonts'a mathata ka lebitso la sebaka.

Lihlopha tsa API

Batla litokomane tsa rona tsa API ka sehlopha:

Li-endpoints tse ling

API e na le li-endpoints bakeng sa ho kenya li-app (/api/v1/deploy-configs/ le /api/v1/deployments/). Ha li hlalosoe ka li-page tsena; ho ngolisoa ha ho ngolisoa ho ngolisa li-endpoints tsohle, tse hlahisoang ho tloha ho API e phelang.

Na u hloka thuso?

Haeba o na le lipotso kapa o hloka thuso ka API, ka kopo o seke oa tsilatsila ho ikopanya le:

• Litekete tsa Tšehetso: Bula tekete ea tšehetso
• Imeile: hello@vps.org
• Litokomane: Litokomane tse Felletseng