> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arqonara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Arqonara Client API Game Panel

**Client API** memungkinkan pengguna untuk melakukan tindakan pada server yang mereka miliki aksesnya. Ini mencakup **Server Management**, **File Operations**, **Database Management**, dan banyak lagi.

## Base URL

Semua request harus diarahkan ke URL berikut:

```bash theme={null}
https://panel.arqonara.com/api/client
```

## Authentication

Semua request Client API memerlukan **Client API Key** yang dikirimkan melalui **Authorization header**.

```bash theme={null}
curl "https://panel.arqonara.com/api/client" \
  -H "Authorization: Bearer ptlc_YOUR_CLIENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: Application/vnd.pterodactyl.v1+json"
```

## API Sections

Berikut adalah kategori fitur yang tersedia dalam API ini:

### Account Management

Kelola detail akun Anda, API keys, dan pengaturan autentikasi.

* **Account Details** - Melihat dan memperbarui informasi akun.
* **Two-Factor Authentication** - Mengaktifkan/menonaktifkan 2FA.
* **API Key Management** - Membuat dan mengelola API keys.
* **Password Management** - Memperbarui kata sandi akun.

### Server Management

Operasi inti dan informasi mengenai server.

* **List Servers** - Mendapatkan daftar semua server yang Anda akses.
* **Server Details** - Mendapatkan informasi detail server tertentu.
* **Server Resources** - Melihat penggunaan resource (CPU/RAM/Disk).
* **Power Management** - Start, stop, dan restart server.
* **Console Access** - Koneksi WebSocket ke konsol server.
* **Send Commands** - Mengirim perintah (command) ke server.

### File Management

Operasi sistem file lengkap untuk server Anda.

* **List Files** - Menjelajahi file dan direktori server.
* **File Contents** - Membaca isi file.
* **Upload Files** - Mengunggah file ke server.
* **Download Files** - Mengunduh file dari server.
* **Create Directory** - Membuat folder baru.
* **Delete Files** - Menghapus file.
* **Copy & Rename** - Menyalin atau mengubah nama file dan direktori.
* **Compress Files** - Membuat arsip (zip/tar).

### Database Management

Kelola database server dan pengguna database.

* **List Databases** - Melihat semua database di server.
* **Create Database** - Membuat database baru.
* **Rotate Password** - Mengubah password database.
* **Delete Database** - Menghapus database.

### Scheduled Tasks

Otomatisasi operasi server dengan jadwal tertentu.

* **List Schedules** - Melihat semua tugas terjadwal.
* **Create Schedule** - Membuat jadwal baru.
* **Manage Tasks** - Menambah/edit/hapus tugas dalam jadwal.
* **Execute Schedule** - Memicu jadwal secara manual.

### Network & Allocations

Kelola alokasi jaringan server dan port.

* **List Allocations** - Melihat alokasi server.
* **Assign Allocations** - Mendapatkan alokasi baru.
* **Primary Allocation** - Mengatur alokasi utama.

### User Management

Kelola subusers dan izin akses pada server.

* **List Users** - Melihat subusers server.
* **User Permissions** - Mengelola izin user.
* **Create Subuser** - Mengundang subuser baru.
* **Remove Subuser** - Menghapus subuser.

### Backups

(Tersedia tergantung konfigurasi panel)

* **List Backups** - Melihat backup server.
* **Create Backup** - Membuat backup baru.
* **Download Backup** - Mengunduh file backup.

***

## Common Parameters

Banyak endpoint mendukung parameter opsional berikut:

### Include Parameters

Menampilkan resource terkait (relasi) dalam respons API.

```bash theme={null}
?include=egg,subusers,allocations
```

### Pagination

Digunakan untuk endpoint yang menampilkan daftar (List endpoints).

```bash theme={null}
?page=2&per_page=50
```

### Filtering

Menyaring hasil berdasarkan kriteria tertentu.

```bash theme={null}
?filter[name]=minecraft&filter[uuid]=1a7ce997
```

### Sorting

Mengurutkan hasil berdasarkan kolom tertentu.

```bash theme={null}
?sort=-created_at&sort=name
```

***

## Response Format

Semua respons API mengikuti struktur JSON berikut:

<CodeGroup>
  ```json Single Resource theme={null}
  {
    "object": "server",
    "attributes": {
      // Data resource
    },
    "meta": {
      // Metadata opsional
    }
  }
  ```

  ```json Resource Collection theme={null}
  {
    "object": "list", 
    "data": [
      {
        "object": "server",
        "attributes": {
          // Data resource
        }
      }
    ],
    "meta": {
      "pagination": {
        "total": 1,
        "count": 1,
        "per_page": 50,
        "current_page": 1,
        "total_pages": 1,
        "links": {}
      }
    }
  }
  ```
</CodeGroup>

***

## Getting Started

### 1. Generate a Client API Key

1. Pergi ke halaman [Account API](https://panel.arqonara.com/account/api).
2. Klik tombol **Create API Key**.
3. Salin key yang dihasilkan (Simpan baik-baik, key tidak akan muncul lagi).

### 2. Make Your First Request

Cobalah request sederhana untuk mengecek koneksi:

```bash theme={null}
curl "https://panel.arqonara.com/api/client" \
  -H "Authorization: Bearer YOUR_CLIENT_API_KEY" \
  -H "Accept: Application/vnd.pterodactyl.v1+json"
```

### 3. Explore Available Servers

Gunakan respons dari request di atas untuk melihat server yang Anda miliki aksesnya. Catat **Server Identifier (UUID)** untuk digunakan pada request selanjutnya.

***

## Rate Limits

Client API dibatasi hingga **240 requests per minute** per API key. Pantau header berikut dalam respons API Anda:

| Header                  | Deskripsi                                         |
| :---------------------- | :------------------------------------------------ |
| `X-RateLimit-Limit`     | Batas maksimal request (240).                     |
| `X-RateLimit-Remaining` | Sisa request yang bisa dilakukan.                 |
| `X-RateLimit-Reset`     | Waktu (Unix timestamp) kapan limit akan di-reset. |

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Account Management" icon="user" href="/api-reference/account">
    Mulai dengan mengetes API Key Anda.
  </Card>

  <Card title="Server Management" icon="server" href="/api-reference/server">
    Jelajahi operasi dasar server.
  </Card>
</CardGroup>