Public API — Gratis, tanpa API key

Welcome to CloudWaves API

Satu endpoint sederhana untuk upload file dan dapatkan link publik. Cocok untuk bot WhatsApp, bot Telegram, atau aplikasi apa pun yang butuh hosting file instan.

Lihat Endpoint ← Kembali ke CloudWaves

Panduan Integrasi API

Jelajahi endpoint yang dirancang untuk mempercepat pengembangan aplikasimu. Tidak perlu daftar, tidak perlu API key — langsung pakai.

Tanpa API Key

Langsung pakai

Cepat

Rata-rata < 2 detik

Maks 100MB

Per file

4 Opsi Expiry

24j s/d permanent

Upload1 Endpoint Tersedia

LainnyaSegera hadir

POST/api/upload

Upload satu file dan terima link publiknya langsung di response. Kirim sebagai multipart/form-data. Ini satu-satunya operasi yang tersedia lewat API publik — tidak ada endpoint untuk menghapus atau mengelola file milik orang lain.

Parameter Body

filewajib

(File) File yang ingin diupload. Maksimal 100MB.

expiry

(string) "24h" · "3d" · "7d" · "permanent". Default: "permanent".

Opsi expiry

24h

24 Jam

Terhapus otomatis setelah 24 jam

3d

3 Hari

Terhapus otomatis setelah 3 hari

7d

7 Hari

Terhapus otomatis setelah 7 hari

permanent

Permanent

Tidak pernah kedaluwarsa (default)

Contoh request

bash

curl -X POST https://cloudwaves.my.id/api/upload \
  -F "file=@/path/ke/file.png" \
  -F "expiry=7d"

Response — 200 OK

json

{
  "id": "aB3xQ9kZ",
  "originalName": "file.png",
  "url": "/aB3xQ9kZ.png",
  "viewUrl": "/f/aB3xQ9kZ",
  "kind": "image",
  "size": 482913,
  "expiresAt": "2026-08-17T09:12:00.000Z"
}

id

ID unik 8 karakter untuk file ini.

originalName

Nama asli file saat diupload.

url

Path link langsung ke file. Gabungkan dengan https://cloudwaves.my.id untuk URL penuh.

viewUrl

Path halaman preview file di CloudWaves.

kind

"image" · "video" · "audio" · "file".

size

Ukuran file dalam byte.

expiresAt

ISO timestamp kedaluwarsa, atau null jika permanent.

Kemungkinan error

400

File tidak ditemukan pada body request.

413

Ukuran file melebihi batas 100MB.

500

Kesalahan server saat upload. Coba lagi.

json

{
  "error": "Ukuran file melebihi batas 100MB."
}

Ketentuan Pemakaian

Dilarang upload konten ilegal, kekerasan eksplisit, atau materi eksploitasi anak.

Kamu bertanggung jawab penuh atas file yang diupload lewat API-mu.

Endpoint ini bisa dibatasi laju request-nya (rate limit) jika terjadi penyalahgunaan.

File otomatis terhapus sesuai opsi expiry yang dipilih — tidak bisa dibatalkan.

Sudah siap integrasi?

Tinggal panggil endpoint di atas dari bot atau aplikasimu. Tidak perlu daftar, tidak perlu API key.