API
HTTPS पर JSON। अपनी API key, Authorization हेडर में भेजें। प्रति मिनट अधिकतम 300 अनुरोध।
बेस पता
https://helpervps.com/api/v1
ऑथेंटिकेशन
हेडर Authorization: Bearer YOUR_API_KEY. पहले टॉप अप के बाद API key पेज पर key बनाएं।
curl https://helpervps.com/api/v1/servers \ -H "Authorization: Bearer YOUR_API_KEY"
GET /catalog
आप जो साइज़, लोकेशन और सिस्टम चुन सकते हैं।
उदाहरण जवाब
{
"plans": [ { "code": "s2", "vcpu": 1, "ram_mb": 2048, "disk_gb": 50, "monthly": "12.00" } ],
"locations": [ "frankfurt", "singapore" ],
"images": [ "ubuntu-24-04", "debian-12" ]
}GET /servers
आपके सर्वर।
उदाहरण जवाब
[
{ "id": 41, "label": "web-1", "state": "running", "ipv4": "192.0.2.15", "paid_until": "2026-11-14T09:00:00Z" }
]POST /servers {"plan":"s2","location":"frankfurt","image":"ubuntu-24-04","label":"web-1"}
सर्वर बनाता है और पहले महीने का भुगतान आपके बैलेंस से करता है। Root पासवर्ड जवाब में एक बार आता है।
उदाहरण जवाब
{
"id": 41,
"state": "creating",
"root_password": "..."
}POST /servers/{id}/start (stop, reboot)
पावर से जुड़े काम।
उदाहरण जवाब
{
"id": 41,
"state": "running"
}POST /servers/{id}/renew
अभी एक और महीने का भुगतान करता है।
उदाहरण जवाब
{
"id": 41,
"paid_until": "2026-12-14T09:00:00Z"
}DELETE /servers/{id}
सर्वर हटाता है। महीने का बचा हिस्सा रिफ़ंड नहीं होता।
उदाहरण जवाब
{
"id": 41,
"state": "deleted"
}एरर
एरर होने पर 2xx के अलावा कोई स्टेटस और एरर कोड वाला JSON बॉडी लौटता है।
| unauthorized | API key नहीं है या गलत है |
| not_allowed | पहले टॉप अप के बाद API खुलता है |
| bad_request | कोई फ़ील्ड नहीं है या गलत है |
| not_enough_balance | पहले टॉप अप करें |
| limit | खाते में बहुत ज़्यादा सर्वर हैं |
| not_created | सर्वर नहीं बन सका; महीने की राशि आपके बैलेंस में वापस आ गई है |
| checking | सप्लायर ने पुष्टि नहीं की; हम सर्वर पूरा करते हैं या महीने की राशि लौटाते हैं |
| not_found | आपके खाते में ऐसा कोई सर्वर नहीं है |
| wrong_state | यह काम सर्वर की मौजूदा स्थिति से मेल नहीं खाता |
| rate_limited | एक मिनट में बहुत ज़्यादा अनुरोध |