Ke Web

Dokumentasi API MahiruDex

Semua endpoint API internal yang disediakan oleh backend MahiruDex untuk mengakses resource MangaDex secara langsung tanpa masalah CORS.

GET /api/manga

Endpoint Pencarian & Eksplorasi Manga

Digunakan untuk melakukan pencarian manga berdasarkan judul, tag/genre, status penerbitan, demografis pembaca, dan melakukan pengurutan hasil secara dinamis.

Parameter Tipe Keterangan
title String Kata kunci pencarian judul manga (Contoh: `title=solo+leveling`)
limit Integer Batas jumlah hasil yang dikembalikan per halaman (Default: `20`)
offset Integer Offset halaman data untuk memuat halaman berikutnya (Default: `0`)
order String Urutan: `followedCount` (terpopuler), `rating` (tertinggi), `createdAt` (baru ditambahkan), `title` (A-Z), `relevance` (pencarian relevan)
status String `ongoing` (berjalan), `completed` (selesai), `hiatus`, `cancelled`
includedTags Array / String UUID tag/genre yang wajib dimiliki manga (dapat diulang untuk beberapa tag)
publicationDemographic String Demografis pembaca: `shounen`, `shoujo`, `seinen`, `josei`
originalLanguage String Bahasa asal: `ja` (Manga Jepang), `ko` (Manhwa Korea), `zh` (Manhua Cina)

Contoh Kasus 1: Pencarian Berdasarkan Judul

curl -X GET "http://localhost:2010/api/manga?title=solo+leveling"

Contoh Kasus 2: Filter Berdasarkan Genre (Action) & Demografis (Seinen)

curl -X GET "http://localhost:2010/api/manga?includedTags=391b0423-db2f-4837-b415-177b4d1b84f9&publicationDemographic=seinen&limit=5"
GET /api/manga/:id

Mendapatkan detail metadata lengkap (judul, deskripsi, cover art, penulis, artis, tags) untuk satu manga tertentu berdasarkan UUID manga.

curl -X GET "http://localhost:2010/api/manga/32d76d19-8a05-4db0-9fc2-e0b0648fe9d0"
GET /api/manga/:id/relation

Mengambil manga yang memiliki relasi cerita (sekuel, prekuel, spin-off, adaptasi, dll.) lengkap dengan link gambar cover art-nya.

curl -X GET "http://localhost:2010/api/manga/32d76d19-8a05-4db0-9fc2-e0b0648fe9d0/relation"
GET /api/manga/:id/feed

Mendapatkan daftar semua chapter untuk suatu manga yang di-sort naik secara numerik.

Parameter Tipe Keterangan
lang String Filter bahasa terjemahan (koma terpisah), Contoh: `id,en` (Default: `en,id`)
curl -X GET "http://localhost:2010/api/manga/32d76d19-8a05-4db0-9fc2-e0b0648fe9d0/feed"
GET /api/chapter/:id

Mendapatkan data URL gambar halaman pembaca untuk satu chapter spesifik.

Parameter Tipe Keterangan
quality String `data` (Kualitas tinggi original) atau `dataSaver` (Kualitas terkompres)
curl -X GET "http://localhost:2010/api/chapter/3390737b-5901-4160-bc6c-7f5dd07bbc4a?quality=data"
GET /api/tags

Mendapatkan semua daftar genre & tag dari MangaDex untuk kategori genre & theme.

curl -X GET "http://localhost:2010/api/tags"
GET /api/manga/random/get

Mendapatkan ID manga acak dari database server MangaDex.

curl -X GET "http://localhost:2010/api/manga/random/get"
GET /api/proxy?url=<url>

Proxy gambar global untuk menghindari pemblokiran CORS / Hotlinking images dari uploads.mangadex.org / *.mangadex.network.

GET /api/iframe-proxy?url=<url>

Proxy halaman web luar (seperti MangaPlus, dll.) agar bisa dirender langsung di dalam tag iframe client kita tanpa terkena block X-Frame-Options.