REFERENSI LENGKAP

API Documentation

Semua endpoint dari api.aldih.icu dan cdn.aldih.icu dirangkum di sini. Untuk versi interaktif ("Try it out"), buka api.aldih.icu/docs.

Downloader PDF Utilitas Shortlink Fun Uploader (REST) CDN Upload CDN Serve & Transform Monitoring
REST API Base URLhttps://api.aldih.icu
CDN API Base URLhttps://cdn.aldih.icu
Rate limit & Auth

Semua endpoint REST API (kecuali /__stat) dibatasi 50 request/menit per IP. Endpoint yang butuh autentikasi ditandai badge kuning di bawah — REST API pakai header Authorization: Bearer <token>, CDN API pakai header x-api-key.

Downloader REST

GET /tiktok

Download video TikTok kualitas tertinggi + metadata lengkap.

Parameter: url (wajib)
GET /youtube

Download video YouTube, pilih resolusi 144p–2160p.

Parameter: url (wajib), resolution (opsional, default 720p)
GET /instagram

Download media dari post/reel Instagram publik.

Parameter: url (wajib)
GET /facebook

Download video Facebook publik kualitas tertinggi.

Parameter: url (wajib)
GET /soundcloud

Download audio SoundCloud, otomatis convert ke MP3.

Parameter: url (wajib)

PDF REST

POST /pdf/to-image

Convert tiap halaman PDF menjadi gambar PNG.

Parameter: file (multipart, PDF)
POST /pdf/image-to-pdf

Gabungkan satu/banyak gambar jadi satu PDF.

Parameter: files[] (multipart, gambar)
POST /pdf/merge

Gabungkan minimal 2 PDF jadi satu dokumen.

Parameter: files[] (multipart, min. 2 PDF)
POST /pdf/split

Pisahkan satu PDF jadi file per halaman.

Parameter: file (multipart, PDF)
POST /pdf/compress

Kompres PDF atau gambar (auto-deteksi tipe).

Parameter: file (multipart), level (screen/ebook/printer), quality (1-100)

Utilitas REST

GET /qrcode

Buat QR code dari teks atau link.

Parameter: text (wajib)
POST /qrcode/decode

Baca isi QR code dari gambar.

Parameter: qrFile (multipart) atau qrUrl (link)
POST /ocr

Ambil teks dari gambar (Tesseract OCR).

Parameter: imageFile/imageUrl, lang (opsional, default eng)
GET /screenshot

Ambil screenshot sebuah website.

Parameter: url (wajib), fullPage, width, height (opsional)

Fun REST

POST /fun/fakeigprofile

Generate gambar fake profile Instagram.

Parameter: ppFile/ppUrl, username, postingan, pengikut, mengikuti, bio (opsional)

Uploader (REST) REST

POST /uploader/upload

Upload 1–10 file sekaligus, auto-kategori & auto-convert gambar ke WebP.

Parameter: files (multipart, maks 10)
GET /uploader/download/:id

Download file berdasarkan ID.

Parameter: id (path), original (opsional)
DELETE /uploader/files/:id

Hapus file berdasarkan ID.

Parameter: id (path)
GET /uploader/stats

Ringkasan agregat jumlah & ukuran file per kategori.

Parameter: -

CDN Upload CDN

POST /upload

Upload file ke CDN (butuh API key), URL permanen + auto dedup.

Parameter: file (multipart) · header x-api-key
POST /upload/url

Fetch file dari URL luar, simpan ke CDN (butuh API key).

Parameter: Body JSON: { "url": "..." } · header x-api-key
POST /upload/public

Upload file ke CDN TANPA API key, publik, maks 50MB.

Parameter: file (multipart)
POST /upload/url/public

Fetch file dari URL luar ke CDN TANPA API key, maks 50MB.

Parameter: Body JSON: { "url": "..." }

CDN Serve & Transform CDN

GET /:filename

Serve file dari CDN. Untuk gambar, mendukung transform on-the-fly.

Parameter: w, h, fit (cover/contain/fill/inside/outside), format (webp/jpeg/png/avif), quality

Monitoring REST + CDN

GET /__stat

Statistik/status server publik (uptime, memory). Tersedia di kedua API.

Parameter: -
GET /monitoring

Dashboard HTML auto-refresh (khusus REST API).

Parameter: -

Auth Admin (REST API) Butuh Token

Panel web resmi: https://api.aldih.icu/admin (login pakai ADMIN_PASSWORD). Semua endpoint di bawah, kecuali login, wajib header Authorization: Bearer <token>.

POST /auth/admin/login

Login, mendapatkan token sesi.

POST /auth/admin/logout

Logout, invalidate token.

GET/POST /auth/admin/keys

List / buat API key baru.

DELETE /auth/admin/keys/:id

Revoke (nonaktifkan) API key.

GET /auth/admin/uploads

Lihat semua file upload (admin only).

DELETE /auth/admin/uploads/:id

Hapus satu file upload.

DELETE /auth/admin/uploads

Reset total semua upload.

GET /auth/admin/folders/:name

Isi folder transient (downloads/screenshots/generated).

DELETE /auth/admin/folders/:name

Kosongkan folder transient sekarang.

POST /auth/admin/cleanup/run

Jalankan cleanup 24 jam manual.

GET /auth/admin/stats

Statistik sistem lengkap.

CDN Admin Butuh API Key

GET /admin/files

List semua file di CDN (pagination: page, limit, scope).

DELETE /admin/files/:scope/:hash

Hapus satu file dari CDN.

GET /admin/stats

Statistik penggunaan CDN (filter scope opsional).