=========================================================
      PUBLIC API GUIDE - Sanka Drive [DISCORD CDN]
=========================================================
INFO: Endpoint ini menggunakan method POST untuk upload & replace.

[ ATURAN PUBLIC UPLOAD ]
- Maksimal ukuran file : 100 MB.
- Rate limit           : 100 Aksi / IP / Hari.
- Keamanan             : Gunakan "delete_token" ATAU "password" kustom.
- File Url             : Gunakan "url" untuk download Dan "stream" untuk fetch/get dll...

[ DETAIL PARAMETER OPSIONAL ]
Berikut adalah parameter yang tidak wajib diisi pada saat Upload:
- "name"       : Nama custom untuk file (jika kosong, pakai nama asli).
- "expires_in" : Masa aktif file dalam angka hari (default: 30 hari - null: Unlimited).
- "hidden"     : Set "true" untuk menyembunyikan file dari list publik.
- "password"   : Password kustom agar file bisa kamu edit/hapus nanti.

---------------------------------------------------------
1. DIRECT UPLOAD (POST)
---------------------------------------------------------
Unggah file baru ke sistem. 

Request:
curl -X POST https://s7.sankavollerei.com/api/upload/direct \
  -F "file=@foto.jpg"        <-- (WAJIB) File yang akan diunggah
  -F "name=rahasia.jpg"      <-- (OPSIONAL) Nama custom
  -F "expires_in=7"          <-- (OPSIONAL) Hapus otomatis dlm X hari
  -F "hidden=true"           <-- (OPSIONAL) Sembunyikan dari list publik
  -F "password=sandi123"     <-- (OPSIONAL) Password untuk kelola file

Respon Sukses (Upload):
{
  "success": true,
  "data": {
    "id": "sanka-9512b782...",
    "name": "[PUBLIC] foto_rahasia.jpg",
    "url": "https://s7.sankavollerei.com/api/download/sanka-9512b782...",
    "stream": "https://s7.sankavollerei.com/api/stream/file/sanka-9512b782",
    "delete_token": "863216c7...",
    "delete_link": "https://s7.sankavollerei.com/api/delete/direct?id=sanka-9512b782...&token=863216c7...",
    "hidden": true,
    "has_password": true,
    "password_token": "katasandi123..."
  }
}

---------------------------------------------------------
2. REPLACE CONTENT (POST)
---------------------------------------------------------
Timpa isi file yang sudah ada dengan file baru. 
URL Download dan ID File akan TETAP SAMA (Permanen).

Request:
curl -X POST https://s7.sankavollerei.com/api/upload/replace/direct \
  -F "id=sanka-xxx"          <-- (WAJIB) ID file yang ingin diganti
  -F "token=sandi123"        <-- (WAJIB) Password kustom / delete_token
  -F "file=@file_baru.zip"   <-- (WAJIB) File penganti baru

---------------------------------------------------------
3. DIRECT DELETE (GET)
---------------------------------------------------------
Hapus file secara permanen menggunakan token atau password.

Request:
curl "https://s7.sankavollerei.com/api/delete/direct?id=sanka-xxx&token=sandi123"

---------------------------------------------------------
4. TOGGLE VISIBILITY (GET)
---------------------------------------------------------
Request (Hide):
curl "https://s7.sankavollerei.com/api/upload/visibility/direct?id=sanka-xxx&token=sandi123&hidden=true"

Request (Unhide):
curl "https://s7.sankavollerei.com/api/upload/visibility/direct?id=sanka-xxx&token=sandi123&hidden=false"
=========================================================