VPS.org API मिसिलीकरण

सुरु गर्दै

VPS.org API ले तपाईंलाई सर्भर, डोमेन, DNS रेकर्ड, ब्याकअप र स्न्यापशटहरू सहित तपाईंको VPS होस्टिङ पूर्वाधारका सबै पक्षहरूलाई प्रोग्रामेटिक रूपमा व्यवस्थापन गर्न अनुमति दिन्छ।

प्रमाणीकरण

सबै API अनुरोधहरूलाई Bearer टोकन प्रयोग गरेर प्रमाणीकरण आवश्यक पर्दछ। तपाईंले आफ्नो खाता सेटिङहरूबाट आफ्नो API टोकन उत्पन्न गर्न सक्नुहुन्छ 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);

प्रत्येक टोकन आफ्नो अनुमतिहरू, जस्तै सर्भरहरू: सूची वा dns: * बोक्छ। टोकनसँग अनुमति आवश्यक छैन कि अनुरोध 403 र हराइरहेको अनुमति नाम required_permission फिल्डसँग अस्वीकार गरिएको छ। अनुमति सन्दर्भ

दर सीमा

प्रमाणित अनुरोध प्रति खाता प्रति घण्टा 1,000 मा सीमित छन्। प्रमाणित नभएको अनुरोध प्रति आईपी ठेगाना प्रति घण्टा 100 मा सीमित छन्। सीमा भन्दा बढी अनुरोधले प्रतिक्षा गर्न सेकेन्डको संख्या दिने Retry-After हेडरसँग 429 प्राप्त गर्दछ। कुनै दर सीमा हेडरहरू सफल प्रतिक्रियाहरूमा पठाइन्छ।

पृष्ठभूमि

सूची अन्त्य बिन्दुहरू गणना, पछिल्लो, अघिल्लो र परिणाम, प्रति पृष्ठ २५ वस्तुहरूसँग वस्तु फर्काउँछ । पृष्ठहरू बीच सार्न पृष्ठ पास गर्नुहोस्, वा यो शून्य सम्म पछिल्लो यूआरएल अनुसरण गर्नुहोस् । सर्भर सूचीले page_size पनि स्वीकार गर्दछ, १०० सम्म ।

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

त्रुटि ह्यान्डलिङ

API ले सफलता वा असफलता संकेत गर्न मानक HTTP स्थिति कोडहरू प्रयोग गर्दछ:

स्थिति कोड	वर्णन
`200`	सफलता - अनुरोध सफलतापूर्वक पूरा भयो।
`201`	सिर्जना गरियो - स्रोत सफलतापूर्वक सिर्जना गरियो
`400`	खराब अनुरोध - अमान्य प्यारामिटर वा विकृत अनुरोध
`202`, `204`	स्वीकार गरियो र लाम लगाइयो (२०२), वा प्रतिक्रिया मुख्य भाग बिना मेटियो (२०४)
`402`	भुक्तानी आवश्यक: फाइलमा कुनै भुक्तानी विधि, भुक्तानी नगरिएको बिल, वा एक अस्वीकार कार्ड पूर्व-अधिकार
`403`	निषेधित: टोकन हराइरहेको छ, अवैध वा म्याद समाप्त भएको छ, वा आवश्यक अनुमतिको कमी छ । असफल प्रमाणीकरणले ४०३ फर्काउँछ, ४०१ होइन ।
`404`	फेला परेन - स्रोत अवस्थित छैन
`409`	द्वन्द: उदाहरणका लागि रिसाइज पहिले नै प्रगतिमा छ, पर्याप्त क्षमता छैन, वा एउटा वितरण पहिले नै चलिरहेको छ
`429`	धेरै अनुरोधहरू - दर सीमा नाघेको छ।
`500`	आन्तरिक सर्भर त्रुटि - हाम्रो तर्फबाट केही गडबड भयो।
`503`	सेवा उपलब्ध छैन: अस्थायी समस्या । पुन: प्रयास गर्नुहोस्, यो पठाउँदा पुन: प्रयास-पछि सम्मान गर्दै ।

त्रुटि मुख्य भागहरू JSON हुन् । धेरैजसोसँग विवरण फिल्ड वा त्रुटि फिल्ड हुन्छ, कहिलेकाहीँ सन्देशसँग; वैधता त्रुटिहरूले फिल्ड नामद्वारा समस्याहरू सूचीबद्ध गर्दछ ।

एपीआई कोटीहरू

श्रेणी अनुसार हाम्रो API कागजातहरू ब्राउज गर्नुहोस्:

सर्भर API 15 अन्तिम बिन्दुहरू

सिर्जना, निरीक्षण, शक्ति, रिसाइज र सर्भरहरू मेट्नुहोस्, मूल पासवर्ड रिसेट गर्नुहोस्, उल्टो डीएनएस सेट गर्नुहोस्, आदेशहरू चलाउनुहोस् र एसएसएच कुञ्जीहरू प्रबन्ध गर्नुहोस्।

कागजात हेर्नुहोस्

ब्याकअप API 4 अन्तिम बिन्दुहरू

तपाईँको सर्भर जगेडा सूचीबद्ध गर्नुहोस्, नयाँ जगेडा सुरु गर्नुहोस्, र जगेडाबाट सर्भर पूर्वावस्थामा ल्याउनुहोस् ।

कागजात हेर्नुहोस्

स्न्यापसट API 4 अन्तिम बिन्दुहरू

सर्भरको लेबुल गरिएको स्न्यापसट लिनुहोस्, तिनीहरूलाई सूचीबद्ध गर्नुहोस् र तिनीहरूलाई मेट्नुहोस् ।

कागजात हेर्नुहोस्

योजना API 2 अन्तिम बिन्दुहरू

उपलब्ध VPS योजनाहरू र मूल्य निर्धारण जानकारी प्राप्त गर्नुहोस्। स्रोतहरू, मूल्य निर्धारण, र उपलब्धताको बारेमा विवरणहरू प्राप्त गर्नुहोस्।

कागजात हेर्नुहोस्

अपरेटिङ सिस्टम एपीआई 2 अन्तिम बिन्दुहरू

तपाईँले स्थापना गर्न सक्नुहुने सञ्चालन प्रणाली र संस्करणहरू सूचीबद्ध गर्नुहोस्, जस्तै उबुन्टु, डेबियन, रक्की लिनक्स, सेन्टओएस स्ट्रिम, फेडोरा र अल्पिन।

कागजात हेर्नुहोस्

डोमेन API 7 अन्तिम बिन्दुहरू

उपलब्धता जाँच, दर्ता र डोमेनहरू पुन: प्राप्त गर्नुहोस्, र नाम सर्भरहरू र स्वचालित पुन: प्राप्ति सेट गर्नुहोस्।

कागजात हेर्नुहोस्

डीएनएस एपीआई 13 अन्तिम बिन्दुहरू

डीएनएस क्षेत्रहरू सिर्जना गर्नुहोस् र सिर्जना गर्नुहोस्, अद्यावधिक गर्नुहोस् र आफ्नो ए, A, CNAME, MX, TXT, SRV, CAA र अन्य रेकर्डहरू मेट्नुहोस्।

कागजात हेर्नुहोस्

स्थान API 2 अन्तिम बिन्दुहरू

सर्भर विकासका लागि उपलब्ध स्थान सूचीबद्ध गर्नुहोस् ।

कागजात हेर्नुहोस्

खाता 1 अन्तिम बिन्दुहरू

खाता प्रोफाइल र API टोकन सूचना पुन: प्राप्त गर्नुहोस् । टोकन कुन खातामा पर्दछ र यसको अनुमतिहरू जाँच गर्नुहोस् ।

कागजात हेर्नुहोस्

संलग्नता 7 अन्तिम बिन्दुहरू

आफ्नो सम्बद्ध शेष, सिफारिस, आयोग र आफ्नो आफ्नै रिपोर्टिंग मा payouts तान्नुहोस्, payout सेटिङ परिवर्तन र अनुरोध payouts।

कागजात हेर्नुहोस्

धेरै अन्त्य बिन्दुहरू

एपीआईमा अनुप्रयोग वितरणका लागि अन्त बिन्दुहरू पनि छन् (/api/v1/deploy-configs/ र /api/v1/deployments/)। तिनीहरू अझै पनि यी पृष्ठहरूमा वर्णन गरिएको छैन; अन्तरक्रियात्मक सन्दर्भले प्रत्येक अन्त बिन्दु सूचीबद्ध गर्दछ, प्रत्यक्ष एपीआईबाट उत्पन्न।

अन्तरक्रियात्मक API सन्दर्भ खोल्नुहोस्

सहयोग चाहियो?

यदि तपाईंसँग प्रश्नहरू छन् वा API सम्बन्धी सहयोग चाहिन्छ भने, कृपया सम्पर्क गर्न नहिचकिचाउनुहोस्:

समर्थन टिकटहरू: समर्थन टिकट खोल्नुहोस्
इमेल: hello@vps.org
मिसिलिकरण: पूर्ण कागजात