API Reseller Panel Pterodactyl

Introduction

API Reseller Perkasa Hosting Indonesia memungkinkan kamu menjual kembali Panel Pterodactyl lewat platform, bot, atau website sendiri. Setiap request yang berhasil akan langsung membuat panel secara otomatis di server kami dan memotong saldo akun kamu sesuai harga produk.

• REST API dengan response JSON, mudah diintegrasikan ke bahasa apa pun.
• Harga produk selalu diambil langsung dari server — bukan dari request kamu.
• Panel dibuat otomatis dalam hitungan detik setelah saldo mencukupi.
• Seluruh transaksi API tercatat rapi di riwayat transaksi akun.

Getting Started

Ikuti 4 langkah berikut untuk mulai berjualan Panel Pterodactyl lewat API dalam waktu singkat.

1. Daftar atau login ke akun Perkasa Hosting Indonesia, lalu buka menu Profil → API Reseller.
2. Klik Buat API Key — sistem otomatis membuat nama Project dan API Key sekaligus, tidak perlu diisi manual.
3. Top up saldo akun minimal Rp50.000 lewat menu Topup Saldo.
4. Kirim request pertama ke https://perkasa-hosting.web.id/api/v1/products dengan header X-Project & Authorization untuk memastikan koneksi berhasil, lalu lanjut ke /panel/create.

Authentication

Setiap request wajib menyertakan nama Project pada header X-Project, dan API Key milik Project tersebut pada header Authorization memakai skema Bearer. Backend akan mencari Project berdasarkan X-Project terlebih dahulu, lalu memvalidasi API Key request terhadap credential Project itu. Request yang tidak menyertakan salah satu header ini akan ditolak dengan status 401/422, dan API Key yang tertukar antar Project akan ditolak dengan status 401.

X-Project: NAMA_PROJECT_ANDA
Authorization: Bearer PH_LIVE_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

• Gunakan HTTPS di setiap request — koneksi non-HTTPS akan ditolak.
• API Key hanya berlaku untuk Project yang sama — mengirim API Key milik Project lain pada header X-Project yang berbeda akan ditolak.
• Jangan pernah menaruh API Key di kode frontend/client-side yang bisa dilihat publik.
• Simpan API Key di environment variable atau secret manager pada server kamu.

Project & API Key

API Key dikelola langsung dari halaman Profil, dikelompokkan per Project. Satu akun bisa membuat lebih dari satu Project — setiap Project punya nama unik dan API Key sendiri, tidak bisa saling dipakai bergantian.

Cara Mendapatkan API Key

1. Login terlebih dahulu ke akun Perkasa Hosting Indonesia.
2. Buka halaman Profil.
3. Cari bagian API Reseller.
4. Klik tombol Buat API Key — Project baru beserta API Key-nya langsung dibuat, tanpa perlu mengisi nama apa pun.
5. Klik tombol Tampilkan pada Project tersebut untuk melihat API Key penuh.
6. Klik tombol Copy API Key untuk menyalinnya.
7. Gunakan nama Project pada header X-Project dan API Key pada header Authorization untuk melakukan request ke API.

Project : VANIA
API Key : PH_LIVE_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

X-Project: VANIA
Authorization: Bearer PH_LIVE_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Products

{
  "status": "success",
  "data": [
    {
      "product_id": "PU_STARTER",
      "category": "umum",
      "name": "Starter",
      "ram": "1GB",
      "cpu": "25%",
      "disk": "Unlimited",
      "price": 2500,
      "billing_period": "monthly",
      "status": "active"
    }
  ]
}

Panel Umum

Daftar harga resmi kategori umum — cocok untuk kebutuhan hosting bot, website, dan aplikasi umum.

Panel Private

Daftar harga resmi kategori private — akses lebih eksklusif dengan kontrol lebih luas per panel.

Create Panel

{
  "product_id": "PU_STARTER",
  "panel_name": "ServerKu",
  "whatsapp": "628xxxxxxxxxx",
  "server_type": "whatsapp"
}

{
  "status": "success",
  "message": "Panel berhasil dibuat",
  "data": {
    "order_id": "PH-20260810-8841",
    "product_id": "PU_STARTER",
    "panel_name": "ServerKu",
    "panel_url": "https://panel.perkasa-hosting.web.id",
    "username": "serverku_a1b2",
    "price_charged": 2500,
    "balance_remaining": 47500,
    "status": "active",
    "created_at": "2026-08-10T09:41:00+07:00"
  }
}

Order Status

{
  "status": "success",
  "data": {
    "order_id": "PH-20260810-8841",
    "product_id": "PU_STARTER",
    "status": "active",
    "panel_url": "https://panel.perkasa-hosting.web.id",
    "created_at": "2026-08-10T09:41:00+07:00"
  }
}

Balance

Saldo API adalah saldo utama akun kamu — dipakai untuk seluruh transaksi pembuatan panel lewat API. Berikut aturan yang wajib dipahami sebelum berjualan.

• Akses transaksi API baru bisa dipakai jika saldo minimal Rp50.000.
• Jika saldo di bawah Rp50.000, akun tidak bisa membuat transaksi panel baru sampai top up kembali.
• Setiap transaksi yang berhasil otomatis memotong saldo sesuai harga produk saat itu juga.
• Selama saldo masih memenuhi syarat minimum akses, transaksi tetap bisa berjalan walau saldo lebih besar dari Rp50.000 sedikit saja — asal cukup untuk harga produk yang dibeli.

{
  "status": "success",
  "data": {
    "balance": 47500,
    "min_required": 50000,
    "api_access": true
  }
}

Contoh Perhitungan Saldo

Transactions

{
  "status": "success",
  "data": [
    {
      "order_id": "PH-20260810-8841",
      "product_id": "PU_STARTER",
      "amount": 2500,
      "type": "panel_create",
      "status": "success",
      "created_at": "2026-08-10T09:41:00+07:00"
    }
  ]
}

Error Codes

Setiap error mengembalikan HTTP status code beserta pesan yang jelas di body response, supaya mudah ditangani di sisi kamu.

Example Integration

Contoh kode membuat panel lewat endpoint /panel/create pada beberapa bahasa yang umum dipakai.

<?php
$projectName = 'VANIA';
$apiKey = 'PH_LIVE_xxxxxxxxxxxxxxxxxxxxxxxxxxxx';
$endpoint = 'https://perkasa-hosting.web.id/api/v1/panel/create';

$payload = [
    'product_id'  => 'PU_STARTER',
    'panel_name'  => 'ServerKu',
    'whatsapp'    => '628xxxxxxxxxx',
];

$ch = curl_init($endpoint);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-Project: ' . $projectName,
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo $result['status'] === 'success'
    ? 'Panel dibuat: ' . $result['data']['panel_url']
    : 'Gagal: ' . $result['message'];

const projectName = 'VANIA';
const apiKey = 'PH_LIVE_xxxxxxxxxxxxxxxxxxxxxxxxxxxx';
const endpoint = 'https://perkasa-hosting.web.id/api/v1/panel/create';

async function createPanel() {
  const res = await fetch(endpoint, {
    method: 'POST',
    headers: {
      'X-Project': projectName,
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      product_id: 'PU_STARTER',
      panel_name: 'ServerKu',
      whatsapp: '628xxxxxxxxxx',
    }),
  });

  const result = await res.json();
  if (result.status === 'success') {
    console.log('Panel dibuat:', result.data.panel_url);
  } else {
    console.error('Gagal:', result.message);
  }
}

createPanel();

curl -X POST "https://perkasa-hosting.web.id/api/v1/panel/create" \
  -H "X-Project: VANIA" \
  -H "Authorization: Bearer PH_LIVE_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "PU_STARTER",
    "panel_name": "ServerKu",
    "whatsapp": "628xxxxxxxxxx"
  }'

Rate Limit

Rate limit berlaku per Project untuk menjaga stabilitas layanan bagi seluruh reseller. Batas default dapat diatur ulang oleh admin sesuai kebutuhan akun tertentu.

Changelog

FAQ API Reseller

Pertanyaan yang paling sering ditanyakan reseller sebelum mulai integrasi API Panel Pterodactyl.

Masih ada pertanyaan lain? Lihat FAQ Perkasa Hosting Indonesia atau hubungi Admin lewat WhatsApp.