API Tools

Tools MineID tersedia sebagai API JSON publik yang gratis. Pakai dari situs webmu, bot Discord, plugin Minecraft, launcher, atau skrip.

URL dasar

https://mineid.my.id/api

• Tanpa akun dan tanpa API key
• Hanya HTTPS — respons berupa JSON (tekstur skin dan berkas addon berupa biner)
• Hanya baca: semua endpoint memakai permintaan GET
• Gratis, dengan batas pemakaian wajar (lihat Batas & Etika Pemakaian)

Bahasa untuk contoh kode

Pilihanmu berlaku untuk semua contoh di halaman ini. Contoh JavaScript untuk Node.js 18+, contoh Java butuh Java 11+.

Ringkasan endpoint

GET /tools/curseforge/search                                   — Cari addon di CurseForge
GET /tools/curseforge/{projectId}                              — Detail satu addon
GET /tools/curseforge/{projectId}/files                        — Daftar file (versi) sebuah addon
GET /tools/curseforge/{projectId}/files/{fileId}/download-url  — Tautan langsung CDN CurseForge untuk sebuah file
GET /tools/curseforge/{projectId}/files/{fileId}/download      — Unduh file lewat MineID
GET /tools/modrinth/search                                     — Cari mod/modpack di Modrinth
GET /tools/modrinth/{projectId}                                — Detail proyek di Modrinth
GET /dlc/search                                                — Cari konten Marketplace DLC PlayFab
GET /dlc/detail/{id}                                           — Detail DLC, file CDN, dan varian unduhan
GET /dlc/download/{id}                                         — Tautan unduhan berkas langsung dan mirror Google Drive
GET /dlc/file/{id}                                             — Unduh file pack DLC terdekripsi (.mcaddon/.mcpack)
GET /dlc/catalog                                               — Katalog DLC lokal terindeks
GET /dlc/categories                                            — Daftar kategori Marketplace DLC
GET /dlc/stats                                                 — Statistik total paket dan kunci terindeks
GET /dlc/creators                                              — Daftar 320+ creator resmi Marketplace
GET /dlc/creators/{id}                                         — Profil & statistik item buatan creator
GET /dlc/creators/{id}/items                                   — Katalog item buatan creator tertentu
GET /tools/skin/{player}                                       — Cari profil skin pemain
GET /tools/skin/texture/{hash}                                 — Unduh tekstur skin (PNG)
GET /tools/server-status                                       — Cek server Java atau Bedrock

Respons & Error

Setiap respons JSON dibungkus amplop sederhana. Selalu periksa kode status HTTP dan field success sebelum membaca data.

Berhasil

{
  "success": true,
  "data": {
    "…": "…"
  }
}

data berisi hasilnya; bentuknya tergantung endpoint.

Daftar (hasil pencarian)

{
  "success": true,
  "data": [
    {
      "…": "…"
    }
  ],
  "pagination": {
    "total": 120,
    "page": 1,
    "limit": 20,
    "totalPages": 6
  }
}

Hasil berhalaman juga memuat pagination: total (semua hasil), page, limit (item per halaman), dan totalPages.

Error

{
  "success": false,
  "message": "Invalid server parameters"
}

Saat gagal, success bernilai false dan message menjelaskan penyebabnya (bahasa Inggris sederhana). Error validasi (400) bisa disertai array errors berisi detail. Pesannya aman ditampilkan ke penggunamu.

Kode status HTTP

Batas & Etika Pemakaian

API ini gratis dan dipakai bersama, jadi ada batas agar tetap cepat dan tersedia untuk semua.

Batas laju (per alamat IP)

Bila batas terlampaui, API menjawab 429 dengan success: false dan sebuah pesan. Tunggu semenit sebelum mencoba lagi.

Cache

Simpan di cache sisi kamu sebisa mungkin. MineID menyimpan profil skin selama 10 menit, dan tekstur skin dikirim dengan Cache-Control: public, max-age=86400, immutable (tekstur dengan hash tertentu tidak pernah berubah). Status server dicek langsung di setiap permintaan (bisa sampai 10 detik bila server lambat).

Etika pemakaian

• Jangan mengecek status server yang sama lebih sering dari tiap 30 detik.
• Simpan hasil pencarian, detail addon, dan skin di cache, jangan mengulang permintaan yang sama.
• Setelah 429, 502, atau 503, tunggu sebelum mencoba lagi — jangan mengulang tanpa jeda.
• Tanpa jaminan uptime: API disediakan apa adanya dan endpoint bisa berubah. Tangani error dengan baik.
• Addon milik penulisnya di CurseForge. Hormati lisensi tiap proyek dan cantumkan penulisnya. MineID adalah platform independen, tidak berafiliasi dengan Mojang, Microsoft, atau CurseForge.

Berkas yang diunduh lewat /download dihitung dalam statistik unduhan publik MineID.

Addon (CurseForge)

Cari dan unduh addon Minecraft — mod, modpack, resource pack, shader, dan data pack untuk Java, serta add-on, map, texture pack, skrip, dan skin untuk Bedrock — lewat integrasi CurseForge milik MineID. Objek di data mengikuti format CurseForge sendiri; field di bawah adalah yang paling berguna.

ID kategori (classId)

Java Edition

Bedrock Edition

Hilangkan classId untuk mencari di semua kategori pada edisi yang dipilih.

Mod loader (modLoaderType)

Khusus Java Edition. Hilangkan untuk mencocokkan loader apa pun.

Jenis rilis file (releaseType)

Modrinth

Proxy pencarian dan detail proyek dari Modrinth Lab. Akses katalog mod, modpack, shader, dan resource pack modern dengan performa tinggi.

Marketplace DLC (PlayFab)

API katalog dan konten resmi Minecraft Marketplace (PlayFab DLC). Mendukung pencarian lokal cepat pada 9.300+ paket terindeks, pengambilan URL CDN asli, dan unduhan berkas terdekripsi siap pakai.

Skin

Cari pemain Java Edition dan ambil tekstur skin mereka. Teksturnya adalah berkas PNG yang dipakai Minecraft sendiri, jadi kamu bisa membuat avatar, model 3D, atau galeri skin.

Status Server

Cek apakah server Minecraft sedang online, berapa pemain yang terhubung, dan versi yang dijalankan. Mendukung Java Edition dan Bedrock Edition.

Direktori Server Indonesia

Ambil daftar server Minecraft Indonesia yang aktif, cari berdasarkan kata kunci, filter edisi (Java, Bedrock, Crossplay), filter tag/gamemode, atau ambil detail lengkap satu server.

Contoh Lengkap

Tiga program kecil namun lengkap yang memakai API ini. Salin satu, ubah pengaturan di bagian atas, lalu jalankan.