Dokumentasi REST API Uploader

Integrasikan layanan Google Drive Uploader NinzDrive ke dalam bot Telegram, WhatsApp bot, script Python, atau web aplikasi Anda.

BASE URL:

POST /upload

Upload file secara instan ke Google Drive dengan streaming resumable. Menghasilkan short URL dan direct streaming link.

Request Parameters (multipart/form-data)

Parameter	Tipe	Wajib	Keterangan
`file`	Binary	Ya	File yang ingin diunggah
`expiry`	String	Tidak	`permanent` (default), `1 jam` (atau `1h`), `24 jam` (atau `24h`), `7 hari` (atau `7d`), `30 hari` (atau `30d`). Untuk testing: `10s`, `1m`, `5m`.

Contoh Response (JSON)

{
  "status": 200,
  "success": true,
  "url": "https://ninzdrive.zone.id/f/aB3x9kL.png",
  "directUrl": "https://ninzdrive.zone.id/f/aB3x9kL.png",
  "downloadUrl": "https://ninzdrive.zone.id/dl/1aMl9pJjPHSIHDCygh...",
  "fileId": "1aMl9pJjPHSIHDCygh...",
  "shortId": "aB3x9kL"
}

GET /f/:shortId

Membuka atau streaming file secara inline dari Google Drive. Gambar dan video langsung dapat diputar di browser atau di-embed di tag <img> dan <video>.

GET /dl/:fileId

Download file langsung dari Google Drive dengan header Content-Disposition: attachment sehingga browser otomatis mendownload file tanpa preview.

GET /api/file/:shortId

Mengambil informasi detail file (nama, ukuran, tanggal upload, expiry, link unduh) dalam format JSON.

GET /api/files

Mengambil daftar seluruh file aktif yang tersimpan di Google Drive beserta total file dan short link.

GET /api/drive-status

Mengecek status ketersediaan akun Google Drive (apakah sudah login dan berapa total file saat ini).

Contoh Integrasi Code

cURL

curl -F "file=@/path/ke/file.jpg" -F "expiry=permanent" https://domain.com/upload

JavaScript (Node.js / Browser)

const formData = new FormData();
formData.append('file', fileBlob, 'gambar.jpg');
formData.append('expiry', 'permanent');

const response = await fetch('https://domain.com/upload', {
    method: 'POST',
    body: formData
});
const data = await response.json();
console.log('Link file:', data.url);

Python (requests)

import requests

with open('foto.jpg', 'rb') as f:
    files = {'file': f}
    data = {'expiry': 'permanent'}
    res = requests.post('https://domain.com/upload', files=files, data=data)
    print(res.json()['url'])