SDIT-R2 Upload API

Endpoint tersedia di {BASE_URL}/api/r2/upload. Gunakan metode POST dengan header x-api-key: <R2_API_KEY> dan body multipart/form-data dengan struktur berikut:

Field Form-Data

FieldWajibDeskripsi
fileYaFile biner yang akan diunggah (maksimal 10MB).
bucketNameTidakNama bucket R2 tujuan. Jika tidak diisi, server menggunakan default dari R2_BUCKET (saat ini public).
folderNameTidakPrefix folderName tanpa karakter / atau \. Default uploads jika kosong.
publicBaseUrlTidakDefault ini https://public.vickykdv.com.
filenameTidakNama file custom. Jika kosong, memakai nama asli file yang diunggah.
contentTypeTidakMIME type explicit. Default mengikuti file.type atauapplication/octet-stream.

Contoh cURL

curl -X POST https://<host>/api/r2/upload \
  -H "x-api-key: <R2_API_KEY>" \
  -F "file=@/path/to/file.png" \
  -F "bucketName=public" \
  -F "folderName=uploads" \
  -F "publicBaseUrl=https://public.vickykdv.com"

Response Example

{
  "ok": true,
  "size": 392955,
  "contentType": "image/png",
  "downloadUrl": "https://images.png"
}

Respons berhasil (HTTP 200) akan berisi key,downloadUrl, dan metadata lain yang dapat Anda simpan di sistem klien.