Referensi API V1

Dokumentasi teknis formal untuk mengintegrasikan kapabilitas distribusi CDN UPLOADER ke dalam arsitektur aplikasi Anda. Endpoint dirancang secara dinamis menggunakan pola RPC.

POST /api/v1/upl

Endpoint uploader universal. Sistem akan secara otomatis mendeteksi dan mengarahkan proses (Single atau Multipart Upload) berdasarkan kombinasi parameter JSON yang dikirimkan dalam request body.

1. Mode Single Upload (Default)

Digunakan untuk inisialisasi sesi transmisi tunggal pada file hingga 5 GB. Menghasilkan token injeksi (Upload URL) langsung ke node terdekat.

{
  "originalName": "konfigurasi_sistem.json",
  "contentType": "application/json",
  "fileSize": 102400,
  "folder": "config/v1"
}
2. Mode Start Multipart

Otomatis aktif jika parameter totalParts dikirimkan. Digunakan untuk mendaftarkan identitas sesi kriptografis beserta peta alokasi fragmen jaringan untuk file besar.

{
  "originalName": "arsip_database_backup.sql.gz",
  "contentType": "application/x-gzip",
  "totalParts": 500,
  "folder": "backups/raw"
}
3. Mode Complete Multipart

Otomatis aktif jika parameter uploadId dan completedParts dikirimkan. Digunakan untuk memvalidasi integritas fragmen ETag dan menyusun ulang aset biner.

{
  "objectKey": "backups/raw/sesi_unik_987.sql.gz",
  "uploadId": "id_sesi_multipart_kriptografis_aman",
  "completedParts": [
    { "PartNumber": 1, "ETag": "checksum_hash_blok_1" },
    { "PartNumber": 2, "ETag": "checksum_hash_blok_2" }
  ]
}

DELETE /api/v1/upl/delete

Memerintahkan terminasi aset dari seluruh node cache CDN UPLOADER. Sistem melakukan verifikasi presensi sebelum menjalankan penghapusan permanen.

{
  "objectKey": "config/v1/konfigurasi_sistem.json"
}