Developer

API Documentation

REST API publik untuk upload image & video. Tanpa API key, tanpa autentikasi, response JSON.

Impor ke Postman, Insomnia, Swagger UI, atau generate SDK dengan OpenAPI Generator.

Overview

RAFZ UPLOADER menyediakan satu endpoint POST /api/public/upload yang menerima file via multipart/form-data dan mengembalikan URL publik permanen. Cocok untuk scraping, bot, automation, integrasi web/mobile, maupun pipeline media.

Base URL

https://rafzuploader.lovable.app

Auth

None (public)

CORS

* (semua origin)

Endpoint

POSThttps://rafzuploader.lovable.app/api/public/upload

Content-Type: multipart/form-data
Method: POST / OPTIONS
Max Image: 50 MB
Max Video: 100 MB

Request Parameter

Field	Type	Required	Deskripsi
file	File (binary)	YES	File image atau video yang diupload.

Response Schema

Semua response berformat application/json.

✓ Success (200)

{
  "success": true,
  "filename": "image.jpg",
  "size": 123456,
  "url": "https://rafzuploader.lovable.app/f/images/abc123.jpg"
}

✗ Error (4xx / 5xx)

{
  "success": false,
  "error": "File too large"
}

success

boolean

filename

string (original name)

size

number (bytes)

url

string (URL publik)

HTTP Status Codes

Code	Status	Penyebab
200	OK	Upload berhasil, response berisi URL file.
400	Bad Request	Field 'file' tidak ditemukan di form-data.
413	Payload Too Large	Ukuran file melebihi limit (50 MB image / 100 MB video).
415	Unsupported Media Type	Tipe file tidak didukung (lihat daftar tipe).
500	Internal Server Error	Kegagalan storage atau error tak terduga di server.

Contoh Kode

curl -X POST https://rafzuploader.lovable.app/api/public/upload \
  -H "Accept: application/json" \
  -F "file=@/path/to/image.jpg"

Struktur URL File

URL yang dikembalikan bersifat permanen dan dapat di-embed langsung (mis. <img src="…">).

https://rafzuploader.lovable.app/f/{folder}/{id}.{ext}

folder — images atau videos
id — UUID 16 karakter yang dihasilkan server
ext — ekstensi sesuai MIME type (jpg, png, mp4, …)

Tipe File Didukung

JPGJPEGPNGWEBPGIFMP4MOVWEBM

MIME type yang divalidasi: image/jpeg, image/png, image/webp, image/gif, video/mp4, video/quicktime, video/webm.

Catatan & Best Practice

Selalu cek field success sebelum memakai url.
Set Content-Type otomatis oleh library (jangan override saat pakai FormData).
Gunakan retry dengan exponential backoff untuk error 5xx.
Hindari upload paralel berlebihan untuk satu sumber IP agar tidak terkena throttling.
File yang sudah diupload tidak dapat dihapus via API publik.
Layanan disediakan gratis — jangan dipakai untuk konten ilegal atau melanggar hak cipta.