REST API Documentation

Quick Start

1. Login ke Server Saya lalu tekan Buat API Key.
2. Simpan key (prefix btzpanel_) — hanya ditampilkan sekali.
3. Kirim di header: Authorization: Bearer <apiKey>.
4. Panggil GET https://btzpanel.my.id/api/v1/servers.

Autentikasi

Sertakan API key di salah satu header berikut. Key tidak boleh lewat query string.

curl -s https://btzpanel.my.id/api/v1/servers \
  -H "Authorization: Bearer btzpanel_xxxxxxxxxxxxxxxx"

const res = await fetch('https://btzpanel.my.id/api/v1/servers', {
  headers: { Authorization: 'Bearer btzpanel_xxxxxxxxxxxxxxxx' }
});
const json = await res.json();
console.log(json.data.servers);

import requests

res = requests.get(
    "https://btzpanel.my.id/api/v1/servers",
    headers={"Authorization": "Bearer btzpanel_xxxxxxxxxxxxxxxx"},
)
print(res.json()["data"]["servers"])

Try It Out

Tempel API key kamu, pilih endpoint, lalu kirim. Key hanya dipakai di browser ini dan tidak disimpan oleh server.

—

Rate Limit

Dua lapis, dihitung per API key. Lewat batas = HTTP 429.

Header respons:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1730467200
X-RateLimit-TPS-Limit: 2
Retry-After: 1

Info key yang dipakai: preview, email, status, dan limit.

{
  "success": true,
  "data": {
    "keyPreview": "btzpanel_...a1b2",
    "email": "user@example.com",
    "tier": "default",
    "active": true,
    "createdAt": "2026-11-01T00:00:00.000Z",
    "rotatedAt": null,
    "lastUsedAt": "2026-11-01T08:30:00.000Z",
    "rateLimit": { "rpm": 60, "tps": 2, "burst": 5, "remaining": 42 }
  }
}

Daftar semua server milik pemilik key.

{
  "success": true,
  "data": {
    "total": 1,
    "servers": [
      {
        "panelId": "123",
        "identifier": "a1b2c3d4",
        "name": "server-pro",
        "package": "Pro 1",
        "cpu": 100,
        "cpuLabel": "100%",
        "ram": 3584,
        "ramLabel": "3584 MB",
        "disk": 4608,
        "diskLabel": "4608 MB",
        "status": "active",
        "suspended": false,
        "expiredAt": "2026-12-12T00:00:00.000Z",
        "expiredLabel": "12/12/2026",
        "daysLeft": 41,
        "isUnlimited": false
      }
    ]
  }
}

Detail satu server. Hanya server milik pemilik key.

curl https://btzpanel.my.id/api/v1/servers/123 \
  -H "Authorization: Bearer btzpanel_xxxxxxxxxxxxxxxx"

Response 200 memakai skema yang sama dengan item di /api/v1/servers. Jika bukan milik key: 404 NOT_FOUND.

Rotasi key. Key lama langsung tidak berlaku; key baru hanya dikembalikan sekali.

{
  "success": true,
  "data": {
    "apiKey": "btzpanel_NEWKEYONLYSHOWNONCE",
    "keyPreview": "btzpanel_...z9y8",
    "rotatedAt": "2026-11-01T09:00:00.000Z"
  }
}

Kode Error

{ "success": false, "code": "RATE_LIMITED", "message": "Kuota request per menit habis." }

Contoh Integrasi

Script cek server yang expired < 3 hari:

const KEY = 'btzpanel_xxxxxxxxxxxxxxxx';
const res = await fetch('https://btzpanel.my.id/api/v1/servers', {
  headers: { Authorization: `Bearer ${KEY}` }
});
const { data } = await res.json();
for (const s of data.servers) {
  if (s.daysLeft !== null && s.daysLeft <= 3) {
    console.log(`⚠ ${s.name} (${s.package}) expired dalam ${s.daysLeft} hari`);
  }
}