Dokumentasi API

Mulai

Base URL produksi:

https://docku.web.id

Format respons

{
  "success": true,
  "message": "...",
  "data": {}
}

Status layanan

GET/api/status

Mengecek status API, mode maintenance, batas upload, dan waktu server.

curl "https://docku.web.id/api/status"

Health check

GET/health

Endpoint ringan untuk health check Pterodactyl, reverse proxy, atau monitor eksternal.

Upload file

POST/api/upload

Kirim satu file dengan field file. Field expires opsional.

Field	Tipe	Wajib	Keterangan
`file`	File	Ya	Maksimal 350 MB.
`expires`	String	Tidak	30m, 60m, 24h, 3d, 7d, 14d, 30d. Default 60m.

cURL

curl -X POST "https://docku.web.id/api/upload" \
  -F "file=@foto.jpg" \
  -F "expires=24h"

JavaScript

const body = new FormData();
body.append('file', fileInput.files[0]);
body.append('expires', '24h');

const response = await fetch('/api/upload', {
  method: 'POST',
  body
});

const result = await response.json();

Contoh respons

{
  "success": true,
  "message": "File berhasil diunggah.",
  "data": {
    "filename": "a1b2c3d4e5f6.jpg",
    "originalName": "foto.jpg",
    "size": 182400,
    "mimeType": "image/jpeg",
    "url": "https://docku.web.id/a1b2c3d4e5f6.jpg",
    "expiresAt": "2026-08-29T02:00:00.000Z"
  }
}

Buat shortlink

POST/api/shorten

Body dikirim sebagai JSON. Hanya URL http:// dan https:// yang diterima.

Field	Tipe	Wajib	Keterangan
`url`	String	Ya	URL tujuan lengkap.
`alias`	String	Tidak	4-32 karakter. Huruf, angka, `-`, dan `_`.

cURL

curl -X POST "https://docku.web.id/api/shorten" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/artikel","alias":"artikel-ku"}'

Contoh respons

{
  "success": true,
  "message": "Tautan berhasil dipersingkat.",
  "data": {
    "alias": "artikel-ku",
    "url": "https://docku.web.id/artikel-ku",
    "target": "https://example.com/artikel"
  }
}

Metadata file

GET/api/file/:filename

Mengambil nama asli, MIME type, ukuran, waktu dibuat, masa kedaluwarsa, dan URL publik tanpa mengunduh isi file.

curl "https://docku.web.id/api/file/a1b2c3d4e5f6.jpg"

Metadata shortlink

GET/api/link/:alias

Mengambil alias, target, URL publik, dan waktu pembuatan.

curl "https://docku.web.id/api/link/artikel-ku"

Akses file publik

GET/:filename

URL hasil upload membuka file secara langsung. Server mendukung Range, ETag, HEAD, dan cache browser. Video, audio, gambar aman, dan PDF dapat ditampilkan inline. Tipe file lain dikirim sebagai attachment.

Byte range

curl -H "Range: bytes=0-1048575" \
  "https://docku.web.id/a1b2c3d4e5f6.mp4"

Status error

HTTP	Arti
400	Input tidak valid, file tidak terbaca, atau format tidak diizinkan.
403	IP atau domain diblokir.
404	Endpoint, file, atau shortlink tidak ditemukan.
409	Alias sudah digunakan atau termasuk alias sistem.
410	File sudah kedaluwarsa atau tidak aktif.
413	Ukuran request terlalu besar.
429	Rate limit tercapai.
503	Maintenance atau API dinonaktifkan.

Batas dan konfigurasi

Maksimal upload: 350 MB.
Upload per menit per IP: 30.
Shortlink per menit per IP: 60.
Tidak menggunakan API key.
File yang kedaluwarsa dibersihkan otomatis setiap 5 menit.

Docku API

Mulai

Format respons

Status layanan

Health check

Upload file

cURL

JavaScript

Contoh respons

Buat shortlink

cURL

Contoh respons

Metadata file

Metadata shortlink

Akses file publik

Byte range

Status error

Batas dan konfigurasi