VPS API কুইক স্টার্ট, API কী তৈরি ও প্রথম সার্ভার তৈরি

ধাপ 2. অথেনটিকেশন ও প্রথম রিকোয়েস্ট

সব রিকোয়েস্ট মূল অ্যাড্রেস https://helpervps.com/api/v1-এর অধীনে পাঠান, আর Authorization: Bearer YOUR_KEY হেডার যুক্ত করুন। প্রথম রিকোয়েস্টে আপনার সার্ভারের তালিকা এনে দেখুন। সার্ভার না থাকলে খালি তালিকা [] ফেরত আসে।

curl -s $HVP/servers -H "Authorization: Bearer $HVP_KEY"

প্রতিটি অ্যাকাউন্ট মিনিটে 300টি পর্যন্ত রিকোয়েস্ট পাঠাতে পারে, আর সার্ভার তৈরি 10 মিনিটে 10 বার পর্যন্ত। অবস্থা যাচাইয়ের বারবার রিকোয়েস্টে কয়েক সেকেন্ডের ব্যবধান রাখলেই যথেষ্ট। সব রেসপন্স JSON, আর ত্রুটি হলে স্ট্যাটাস কোডসহ {"error": "code"} আকারে ফেরত আসে।

ধাপ 3. স্পেক, অঞ্চল ও ইমেজ বাছাই

সার্ভার তৈরির সময় দেওয়া সব মান ক্যাটালগ থেকে আসে। GET /catalog বিক্রি চলা স্পেক (plans), অঞ্চল (locations), ইমেজ (images) ও অতিরিক্ত অপশন (addons) একবারে ফেরত দেয়। jq থাকলে দরকারি অংশ বেছে দেখা সুবিধাজনক।

curl -s $HVP/catalog -H "Authorization: Bearer $HVP_KEY" | jq '.plans[] | {code, type, vcpu, ram_mb, disk_gb, monthly}'
curl -s $HVP/catalog -H "Authorization: Bearer $HVP_KEY" | jq '.locations, .images'

• স্পেক কোড: s1, s2-এর মতো ধরন ও সাইজ বোঝায়। type হলো basic (SSD স্ট্যান্ডার্ড), fast (NVMe হাই পারফরম্যান্স), cpu (ডেডিকেটেড CPU) ও mem (বেশি মেমরি)। monthly হলো মার্কিন ডলারে মাসিক ফি।
• অঞ্চলের কোড: frankfurt, singapore, seoul-এর মতো শহরের নাম।
• ইমেজের কোড: ubuntu-24-04, debian-13, almalinux-10-এর মতো অপারেটিং সিস্টেম আর app-docker, app-wordpress-এর মতো অ্যাপ।
• অতিরিক্ত অপশন: অটো ব্যাকআপের হার, অতিরিক্ত ডিস্কের সাইজ ও প্রতি GB ফি আর DDoS সুরক্ষার ফি। বিক্রি না হওয়া অপশন null হিসেবে আসে।

Ubuntu-তে না থাকলে apt install -y jq, আর Mac-এ brew install jq দিয়ে ইনস্টল করুন। স্ক্রিনে বাছাইয়ের তালিকার মতোই, তাই স্পেক অনুযায়ী পার্থক্য দামের পেজ-এর সাথে মিলিয়ে দেখলে সুবিধা।

ধাপ 4. সার্ভার তৈরি

প্ল্যান, লোকেশন, ইমেজ ও নাম JSON হিসেবে POST /servers-এ পাঠান। আপনার চয়েস করা প্ল্যানের প্রথম মেয়াদের ফি পেমেন্ট করুন এবং সার্ভার তৈরি শুরু হবে।

curl -s -X POST $HVP/servers \
  -H "Authorization: Bearer $HVP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan":"s2","location":"frankfurt","image":"ubuntu-24-04","label":"web-1"}'

সফল হলে স্ট্যাটাস কোড 201-সহ সার্ভারের তথ্য ফেরত আসে। id হলো S-XXXX-XXXX-XXXX আকারের সার্ভার কোড, আর পরের সব রিকোয়েস্টে এই কোড ব্যবহার করুন। root_password এই রেসপন্সে একবার থাকে, তাই সঙ্গে সঙ্গে সেভ করুন। সার্ভার পেজেও 7 দিন দেখা যায়।

• label: সার্ভারের নাম। ইংরেজি অক্ষর, সংখ্যা, ডট ও হাইফেন দিয়ে 40 অক্ষর পর্যন্ত লিখুন, অন্য অক্ষর হাইফেনে বদলে যায়।
• backups: true হলে অটো ব্যাকআপ চালু হয়।
• extra_disk_gb: অতিরিক্ত NVMe ব্লক ডিস্কের সাইজ। ক্যাটালগের sizes_gb মানের (50, 100, 250, 500, 1000) একটি দিন।
• ddos_protection: true হলে DDoS সুরক্ষা চালু হয়।

অপশনের ফি সার্ভারের মাসিক ফি-র সাথে যোগ হয়ে রেসপন্সের monthly-তে দেখা যায়, আর প্রতি পেমেন্টের তারিখে একই পরিমাণে স্বয়ংক্রিয়ভাবে রিনিউ হয়। প্রতিটি অ্যাকাউন্টে 10টি পর্যন্ত সার্ভার তৈরি করা যায়।

ধাপ 5. অবস্থা যাচাই ও সংযোগ

নতুন সার্ভার creating অবস্থায় শুরু হয়, প্রস্তুত হলে running হয় আর ipv4 অ্যাড্রেস পূরণ হয়। নিচের লুপ প্রতি 10 সেকেন্ডে অবস্থা দেখে, আর running হলে IP দেখায়। সার্ভার কোড আপনার সার্ভারের কোড দিয়ে বদলান।

ID=S-XXXX-XXXX-XXXX
until [ "$(curl -s $HVP/servers/$ID -H "Authorization: Bearer $HVP_KEY" | jq -r .state)" = "running" ]; do sleep 10; done
curl -s $HVP/servers/$ID -H "Authorization: Bearer $HVP_KEY" | jq -r .ipv4

অবস্থার মান হলো creating, running, stopped, rebooting, installing, suspended বা check-এর একটি। suspended মানে সার্ভারটি বিলিং তারিখে রিনিউ না হওয়ায় স্থগিত হয়েছে, আর check মানে আমরা সার্ভার সেটআপের ফলাফল যাচাই করছি। IP দেখা গেলে ssh root@IP দিয়ে সংযোগ করুন। সংযোগের উপায় প্রথম লগইন গাইড-এ আছে।

ধাপ 6. পাওয়ার, রিনিউ ও ডিলিট

curl -s -X POST $HVP/servers/$ID/stop   -H "Authorization: Bearer $HVP_KEY"
curl -s -X POST $HVP/servers/$ID/start  -H "Authorization: Bearer $HVP_KEY"
curl -s -X POST $HVP/servers/$ID/reboot -H "Authorization: Bearer $HVP_KEY"
curl -s -X POST $HVP/servers/$ID/renew  -H "Authorization: Bearer $HVP_KEY"
curl -s -X DELETE $HVP/servers/$ID     -H "Authorization: Bearer $HVP_KEY"

• start: বন্ধ (stopped) সার্ভার চালু করে।
• stop, reboot: চালু (running) সার্ভার বন্ধ বা রিস্টার্ট করে।
• renew: এখনই আরও 1, 3, 6 বা 12 মাসের পেমেন্ট করে। স্থগিত (suspended) সার্ভারও এই রিকোয়েস্টে আবার চালু হয়।
• DELETE: সার্ভার ও ডিস্ক ডিলিট করে {"state": "deleted"} ফেরত দেয়। আগেই পেমেন্ট করা মাসের বাকি সময়ের টাকা ফেরত হয় না।

বর্তমান অবস্থায় করা যায় না এমন কাজ পাঠালে 409 wrong_state ফেরত আসে। যেমন আগে থেকে চালু সার্ভারে start পাঠালে। রিইনস্টল ও নতুন root পাসওয়ার্ড তৈরি সার্ভার পেজ থেকে করুন। ক্রম রিইনস্টল গাইড-এ আছে।

Python দিয়ে একই ক্রম চালানো

একই প্রবাহ Python স্ক্রিপ্টে লিখলে এমন হয়। requests লাইব্রেরি (pip install requests) ব্যবহার করুন।

import os, time, requests

API = "https://helpervps.com/api/v1"
H = {"Authorization": f"Bearer {os.environ['HVP_KEY']}"}

r = requests.post(f"{API}/servers", headers=H, json={
    "plan": "s2", "location": "frankfurt",
    "image": "ubuntu-24-04", "label": "web-1",
})
r.raise_for_status()
server = r.json()
print("id:", server["id"], "root password:", server["root_password"])

while True:
    s = requests.get(f"{API}/servers/{server['id']}", headers=H).json()
    if s["state"] == "running" and s["ipv4"]:
        print("ready:", s["ipv4"])
        break
    time.sleep(10)

প্রায়ই দেখা ত্রুটির কোড

• 401 unauthorized: কী নেই বা ভুল। হেডার Authorization: Bearer hvp_... আকারে আছে কি না দেখুন।
• 403 not_allowed: আপনার প্রথম পেমেন্ট নিশ্চিত হওয়ার পর খোলে।
• 400 bad_request: ফিল্ডের নাম বা মান ভুল। কোড ক্যাটালগের মান হুবহু ব্যবহার করুন।
• 402 not_enough_balance: পেমেন্টের পরিমাণ $25-এর কম। অন্তত $25 সহ আবার পাঠান।
• 409 limit: অ্যাকাউন্টে তৈরি করা যায় এমন সার্ভারের সংখ্যায় পৌঁছে গেছেন।
• 409 not_created: সার্ভার তৈরি হয়নি, আর ফি আপনার অ্যাকাউন্ট ক্রেডিটে ফিরে আসে।
• 202 checking: আমরা সার্ভার সেটআপের ফলাফল যাচাই করছি। একই রিকোয়েস্ট আবার পাঠাবেন না; আপনার সার্ভার তালিকা দেখুন। সার্ভার সম্পূর্ণ হবে বা ফি আপনার অ্যাকাউন্ট ক্রেডিটে ফিরে আসবে।
• 404 not_found: আপনার অ্যাকাউন্টে নেই এমন সার্ভার কোড বা অ্যাড্রেস।
• 409 wrong_state: বর্তমান অবস্থায় করা যায় না এমন কাজ।
• 429 rate_limited: মিনিটের রিকোয়েস্টের সীমায় পৌঁছে গেছেন। একটু অপেক্ষা করে পাঠান।

সব এন্ডপয়েন্ট, রেসপন্সের ফিল্ড ও উদাহরণ API ডকুমেন্ট-এ এক জায়গায় আছে। API দিয়ে কী করা যায় আর এর ব্যবহার VPS API পেজে দেখতে পারবেন।