API
JSON lewat HTTPS. Kirim API key Anda di header Authorization. Maksimal 300 permintaan per menit.
Alamat dasar
https://helpervps.com/api/v1
Autentikasi
Header Authorization: Bearer YOUR_API_KEY. Buat key di halaman API key setelah pengisian saldo pertama Anda.
curl https://helpervps.com/api/v1/servers \ -H "Authorization: Bearer YOUR_API_KEY"
GET /catalog
Ukuran, lokasi, dan sistem yang dapat Anda pilih.
Contoh respons
{
"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
Server Anda.
Contoh respons
[
{ "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"}
Membuat server dan membayar bulan pertama dari saldo Anda. Kata sandi root ada di respons satu kali saja.
Contoh respons
{
"id": 41,
"state": "creating",
"root_password": "..."
}POST /servers/{id}/start (stop, reboot)
Aksi daya.
Contoh respons
{
"id": 41,
"state": "running"
}POST /servers/{id}/renew
Membayar satu bulan lagi sekarang.
Contoh respons
{
"id": 41,
"paid_until": "2026-12-14T09:00:00Z"
}DELETE /servers/{id}
Menghapus server. Sisa bulannya tidak dikembalikan.
Contoh respons
{
"id": 41,
"state": "deleted"
}Error
Error mengembalikan status selain 2xx dan body JSON berisi kode error.
| unauthorized | API key tidak ada atau salah |
| not_allowed | API terbuka setelah pengisian saldo pertama Anda |
| bad_request | Ada kolom yang tidak ada atau salah |
| not_enough_balance | Isi saldo terlebih dahulu |
| limit | Terlalu banyak server di akun |
| not_created | Server tidak dapat dibuat; biaya bulan tersebut sudah kembali ke saldo Anda |
| checking | Pemasok tidak mengonfirmasi; kami menyelesaikan server atau mengembalikan biaya bulan tersebut |
| not_found | Server tersebut tidak ada di akun Anda |
| wrong_state | Aksi ini tidak sesuai dengan status server saat ini |
| rate_limited | Terlalu banyak permintaan dalam satu menit |