API Publik
API HTTP kecil yang hanya bisa dibaca untuk mengambil status server dari luar panel: dasbor status, monitor waktu aktif, bot Discord, aturan otomatisasi rumah. Ini disajikan oleh panel itu sendiri dan mengembalikan data langsung yang sama yang ditampilkan oleh halaman panel itu sendiri (dari cache dalam memori), jadi memantaunya tidak pernah menyentuh Docker.
Ini mati sampai admin menggunakannya dan dibatasi admin. Tidak ada yang diekspos sampai token ada.
Mengaktifkannya
Section titled “Mengaktifkannya”Pengaturan → API Publik → Kunci Baru. Beri nama, pilih apa yang bisa dilihatnya (semua server, atau subset tertentu), dan secara opsional tanggal kedaluwarsa. Kunci lengkap (token Bearer) ditampilkan sekali, dalam dialog; salin sekarang, karena hanya awalan pendek yang disimpan setelahnya, untuk identifikasi dalam daftar.

Membuat kunci pertama akan mengaktifkan API secara otomatis (sakelar Biarkan aplikasi luar membaca status adalah kontrol jeda: matikan untuk berhenti menyajikan tanpa membatalkan kunci apa pun). Batalkan kunci dari tabel yang sama kapan saja; klien yang menggunakannya akan segera kehilangan akses.
Token disimpan sebagai hash SHA-256 (tidak pernah dalam teks biasa), bertahan dari restart panel, dan melampaui server yang dibatasinya (server yang dihapus hanya akan hilang dari hasil token tersebut).
Otentikasi
Section titled “Otentikasi”Kirim token sebagai kredensial Bearer:
Authorization: Bearer msm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxTidak ada cookie dan tidak ada CORS: ini untuk pemanggil server-ke-server dan CLI, bukan aplikasi peramban dari asal lain. Jika panel berada di belakang proxy terbalik, pastikan proxy meneruskan header Authorization.
Kegagalan mengembalikan 401 dengan { "ok": false, "error": "..." }. Apa pun selain GET (atau HEAD) mengembalikan 405. Jalur yang tidak diketahui mengembalikan 404. Ketika API dinonaktifkan, setiap rute mengembalikan 404.
Batas tarif
Section titled “Batas tarif”Setiap token mendapatkan anggarannya sendiri, RATE_LIMIT_PUBLIC_API_PER_MIN (default 120 permintaan/menit; 0 menonaktifkan pembatas). Melebihi batas mengembalikan 429. Setiap permintaan, bahkan sebelum tokennya diperiksa, juga dihitung terhadap batas per IP klien sebanyak lima kali jumlah tersebut, jadi menyelidiki dengan token yang hilang, salah format, dicabut, atau kedaluwarsa tidak dapat melewati anggaran dengan memutarnya.
Titik akhir
Section titled “Titik akhir”GET /api/v1/servers
Section titled “GET /api/v1/servers”Setiap server yang dibatasi oleh token.
{ "ok": true, "total": 1, "online": 1, "servers": [ { "id": "srv_ab12cd34", "name": "SMP", "type": "PAPER", "state": "running", "cpuPct": 18.4, "memoryMb": 2048, "memoryLimitMb": 4096, "uptimeSeconds": 11722, "players": { "online": 3, "max": 20 } } ]}GET /api/v1/servers/:id
Section titled “GET /api/v1/servers/:id”Satu server, objek yang sama di bawah kunci server. Mengembalikan 404 untuk id yang tidak diketahui dan untuk server yang tidak dibatasi oleh token (tidak ada peramal keberadaan), dan 400 untuk id yang salah format.
Bidang respons
Section titled “Bidang respons”| Bidang | Arti |
|---|---|
total |
Berapa banyak server yang terlihat oleh token ini (setelah filter cakupannya). |
online |
Berapa banyak dari itu dalam status: running. |
id |
Id server yang stabil (srv_...). |
name |
Nama tampilan. |
type |
Tipe server itzg (PAPER, FABRIC, AUTO_CURSEFORGE, …). |
state |
running, starting, stopped, atau crashed: ringkasan stabil dari status internal panel. |
cpuPct |
Persentase CPU terbaru, atau null ketika server tidak berjalan. |
memoryMb |
Memori residen dalam MB, atau null. |
memoryLimitMb |
Batas memori kontainer yang dikonfigurasi dalam MB, atau null. |
uptimeSeconds |
Detik sejak kontainer dimulai, atau null. |
players |
{ online, max }, atau null sampai server melaporkan daftar pemain. |
Contoh
Section titled “Contoh”curl -s https://panel.example.com/api/v1/servers \ -H "Authorization: Bearer $MSM_TOKEN" | jq