VPS.org API ডকুমেন্টেশন

শুরু করা

VPS.org API আপনাকে আপনার VPS হোস্টিং অবকাঠামোর সমস্ত দিক প্রোগ্রাম্যাটিকভাবে পরিচালনা করতে দেয়, যার মধ্যে রয়েছে সার্ভার, ডোমেন, DNS রেকর্ড, ব্যাকআপ এবং স্ন্যাপশট।

প্রমাণীকরণ

সমস্ত 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);

প্রত্যেক টোকেন তার নিজস্ব অনুমতি বহন করে, যেমন servers:list অথবা dns:*। টোকেনের অনুমতির প্রয়োজনে যে অনুরোধ করা হয় তা 403 এবং required_permission ক্ষেত্র ব্যবহার করে প্রত্যাখ্যান করা হয়। অনুমতি সংক্রান্ত রেফারেন্স

হার সীমাবদ্ধতা

অনুমোদিত অনুরোধ প্রতি অ্যাকাউন্ট প্রতি ঘন্টায় ১,০০০ পর্যন্ত সীমাবদ্ধ করা হয়েছে। অনুমোদন না করা অনুরোধ প্রতি IP ঠিকানা প্রতি ঘন্টায় ১০০ পর্যন্ত সীমাবদ্ধ করা হয়েছে। সীমার অতিরিক্ত অনুরোধের জন্য 429 এবং Retry-After শীর্ষচরণ প্রদান করা হবে যা অপেক্ষা করার সেকেন্ডের সংখ্যা নির্দেশ করে। সফল প্রতিক্রিয়ার ক্ষেত্রে কোনো রেট লিমিট শীর্ষচরণ প্রেরণ করা হবে না।

পৃষ্ঠা সংখ্যা

তালিকার শেষ বিন্দু একটি বস্তু ফিরিয়ে দেয় যার সংখ্যা, পরবর্তী, পূর্ববর্তী এবং ফলাফল, প্রতি পৃষ্ঠায় ২৫টি বস্তু। পৃষ্ঠার মধ্যে স্থানান্তর করতে পৃষ্ঠাটি পাস করুন, অথবা পরবর্তী URL অনুসরণ করুন যতক্ষণ না তা নূল হয়। সার্ভারের তালিকা page_size গ্রহণ করে, ১০০ পর্যন্ত।

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

ত্রুটি পরিচালনা

সাফল্য বা ব্যর্থতা নির্দেশ করতে API স্ট্যান্ডার্ড HTTP স্ট্যাটাস কোড ব্যবহার করে:

সমস্যার মূল অংশ JSON। অধিকাংশ ক্ষেত্রেই একটি বিস্তারিত ক্ষেত্র অথবা একটি সমস্যা ক্ষেত্র রয়েছে, কখনও কখনও একটি বার্তা সহ; বৈধতা পরীক্ষার সমস্যা ক্ষেত্র নাম অনুযায়ী সমস্যার তালিকা প্রদর্শন করে।

এপিআই বিভাগ

বিভাগ অনুসারে আমাদের API ডকুমেন্টেশন ব্রাউজ করুন:

আরও বেশি এনডোমেন্ট

API-র অ্যাপলিকেশন স্থাপনের জন্যও এনডপয়েন্ট রয়েছে (/api/v1/deploy-configs/ এবং /api/v1/deployments/)। এগুলো এই পৃষ্ঠাতে এখনো বর্ণনা করা হয়নি; মিথস্ক্রিয় রেফারেন্সে প্রত্যেক এনডপয়েন্টের তালিকা রয়েছে, যা লাইভ API থেকে উৎপাদিত।

সাহায্য দরকার?

আপনার যদি প্রশ্ন থাকে অথবা API সম্পর্কে সহায়তার প্রয়োজন হয়, তাহলে অনুগ্রহ করে যোগাযোগ করতে দ্বিধা করবেন না:

• সাপোর্ট টিকিট: একটি সাপোর্ট টিকিট খুলুন
• ইমেইল: hello@vps.org
• নথি: সম্পূর্ণ ডকুমেন্টেশন