VPS.org API ලේඛන

ඇරඹේ

VPS.org API මඟින් ඔබට සේවාදායකයන්, වසම්, DNS වාර්තා, උපස්ථ සහ ස්නැප්ෂොට් ඇතුළුව ඔබේ VPS සත්කාරක යටිතල ව්‍යුහයේ සියලුම අංග ක්‍රමලේඛනගතව කළමනාකරණය කිරීමට ඉඩ සලසයි.

සත්‍යාපනය

සියලුම API ඉල්ලීම් සඳහා Bearer ටෝකනයක් භාවිතයෙන් සත්‍යාපනය අවශ්‍ය වේ. ඔබට ඔබගේ ගිණුම් සැකසුම් වලින් ඔබගේ API ටෝකනය ජනනය කළ හැක 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);

එක් එක් ටොකන්, සේවාදායකයින් ලෙස, එහි ම අවසර ගනී: ලැයිස්තුව හෝ DNS: *. ටොකන් නොමැති අවසර අවශ්ය බව ඉල්ලීමක් 403 හා අතුරුදහන් අවසර නම් required_permission ක්ෂේත්රයේ සමග ප්රතික්ෂේප කරනු ලැබේ. අවසර උපුටාදැක්වීම්

අනුපාත සීමා කිරීම

ගිණුමකට පැයකට 1,000 ක් දක්වා සත්යතාවය සහතික කර ඇති ඉල්ලීම් සීමා කර ඇත. සත්යතාවය සහතික නොකළ ඉල්ලීම් IP ලිපිනයකට පැයකට 100 ක් දක්වා සීමා කර ඇත. සීමාව ඉක්මවා ඉල්ලීමක් ලැබේ 429 බලා සිටීමට තත්පර ගණනක් ලබා දෙන නැවත උත්සාහ කිරීමෙන් පසු ශීර්ෂය සමඟ. සාර්ථක ප්රතිචාර මත කිසිදු අනුපාත සීමා ශීර්ෂ යවනු නොලැබේ.

පිටු සැකසීම

ලැයිස්තු අවසන් ස්ථානය ගණන්, ඊළඟ, පෙර හා ප්රතිඵල, පිටුවකට අයිතම 25 සමග වස්තුව ආපසු. පිටු අතර ගමන් කිරීමට පිටුව, හෝ එය ශුන්‍ය වන තෙක් ඊළඟ URL අනුගමනය. සේවාදායක ලැයිස්තුව ද page_size පිළිගනී, 100 දක්වා.

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

දෝෂ හැසිරවීම

සාර්ථකත්වය හෝ අසාර්ථකත්වය දැක්වීමට API සම්මත HTTP තත්ව කේත භාවිතා කරයි:

දෝෂ ශරීර JSON වේ. බොහෝ විට පණිවිඩයක් සමග සමහර විට, විස්තර ක්ෂේත්ර හෝ දෝෂ ක්ෂේත්ර ඇත; වලංගු දෝෂ ක්ෂේත්ර නාමය විසින් ගැටළු ලැයිස්තුගත.

API කාණ්ඩ

කාණ්ඩය අනුව අපගේ API ලේඛන පිරික්සන්න:

තවත් අවසාන ස්ථානයන්

API ද යෙදුම් යෙදවුම් සඳහා අවසන් ස්ථානයන් ඇත (/api/v1/deploy-configs/ සහ /api/v1/deployments/). ඔවුන් තවමත් මෙම පිටු මත විස්තර කර නැත; අන්තර්ක්රියාකාරී උපුටා සෑම අවසන් ස්ථානයක් ලැයිස්තුගත, සජීවී API සිට ජනනය.

උදව් අවශ්‍යයි?

ඔබට කිසියම් ප්‍රශ්නයක් ඇත්නම් හෝ API සම්බන්ධයෙන් සහාය අවශ්‍ය නම්, කරුණාකර පහත සඳහන් දෑ සම්බන්ධ කර ගැනීමට පසුබට නොවන්න:

• ආධාරක ටිකට්පත්: සහාය ටිකට් පතක් විවෘත කරන්න
• විද්‍යුත් තැපෑල: hello@vps.org
• ලේඛන: සම්පූර්ණ ලියකියවිලි