fm_be/docs/file-manager-get.md

File Manager - GET Data (Step by Step)

Daftar Endpoint

Ringkasan Endpoint Utama

1. GET /file-manager/get-all untuk explorer merged (root/child)
2. GET /file-manager/trash/get-all untuk trash merged
3. GET /file-manager/files/get/:uuid untuk detail file
4. GET /file-manager/folders/get/:uuid untuk detail folder

Endpoint Removed (tidak tersedia lagi)

1. GET /file-manager/files/get-all
2. GET /file-manager/folders/get-all
3. GET /file-manager/files/get-all-trash
4. GET /file-manager/folders/get-all-trash

Step 1 - Ambil Explorer Root

Endpoint

• GET /api/v1/file-manager/get-all

Tujuan

• menampilkan isi root explorer (merged folder + file).

Contoh response

{
  "data": [
    {
      "type": "file_manager_node",
      "id": "folder-uuid",
      "attributes": {
        "node_type": "folder",
        "name": "Documents",
        "status": "ready",
        "path_cache": "/Documents",
        "created_at": "2026-03-31T08:52:03Z",
        "updated_at": "2026-03-31T08:52:03Z"
      }
    },
    {
      "type": "file_manager_node",
      "id": "file-uuid",
      "attributes": {
        "node_type": "file",
        "name": "LOGO.png",
        "extension": "png",
        "size_bytes": 100988,
        "mime_type": "image/png",
        "download_url": "https://...",
        "status": "ready",
        "created_at": "2026-03-31T09:30:31Z",
        "updated_at": "2026-03-31T09:30:31Z"
      }
    }
  ],
  "meta": {
    "is_root": true,
    "folders": 1,
    "files": 1,
    "total": 2
  }
}

Step 2 - Buka Isi Folder

Endpoint

• GET /api/v1/file-manager/get-all?parent_uuid=<folder_uuid>

Tujuan

• menampilkan child langsung dari folder yang dipilih.

Contoh response

{
  "data": [
    {
      "type": "file_manager_node",
      "id": "inside-file-uuid",
      "attributes": {
        "node_type": "file",
        "parent_id": "folder-uuid",
        "name": "inside-folder.png",
        "extension": "png",
        "size_bytes": 42170,
        "mime_type": "image/png",
        "download_url": "https://...",
        "status": "ready",
        "created_at": "2026-04-05T07:29:33Z",
        "updated_at": "2026-04-05T07:33:44Z"
      }
    }
  ],
  "meta": {
    "is_root": false,
    "parent_uuid": "folder-uuid",
    "breadcrumb": [
      {
        "id": "folder-uuid-level-1",
        "name": "Documents"
      },
      {
        "id": "folder-uuid",
        "name": "Project A"
      }
    ],
    "folders": 0,
    "files": 1,
    "total": 1
  }
}

Step 2b - Ambil Data Trash (Merged)

Endpoint

• GET /api/v1/file-manager/trash/get-all

Tujuan

• menampilkan daftar node yang sedang trashed (folder + file).

Contoh response

{
  "data": [
    {
      "type": "file_manager_trash_node",
      "id": "folder-uuid",
      "attributes": {
        "node_type": "folder",
        "name": "Documents",
        "path_cache": "/Documents",
        "trashed_at": "2026-04-01T10:00:00Z"
      }
    },
    {
      "type": "file_manager_trash_node",
      "id": "file-uuid",
      "attributes": {
        "node_type": "file",
        "name": "logo.png",
        "extension": "png",
        "size_bytes": 42170,
        "mime_type": "image/png",
        "download_url": "https://...",
        "trashed_at": "2026-04-01T10:00:00Z"
      }
    }
  ],
  "meta": {
    "total": 2
  }
}

Step 3 - Ambil Detail File

Endpoint

• GET /api/v1/file-manager/files/get/:uuid

Tujuan

• ambil detail information dari satu file untuk panel/detail page.

Contoh response

{
  "data": {
    "type": "file_manager_file",
    "id": "file-uuid",
    "attributes": {
      "name": "spidey.png",
      "name_normalized": "spidey.png",
      "extension": "png",
      "size_bytes": 42170,
      "mime_type": "image/png",
      "download_url": "https://...",
      "status": "ready",
      "location": {
        "folder_id": "folder-uuid"
      },
      "processing": {
        "processing_started_at": "2026-04-05T07:29:34Z",
        "processed_at": "2026-04-05T07:29:34Z",
        "validated_at": "2026-04-05T07:29:34Z"
      },
      "audit": {
        "created_at": "2026-04-05T07:29:33Z",
        "created_by": "019d194e-f595-7d5f-a5bf-3609231ba43d",
        "updated_at": "2026-04-05T07:33:44Z",
        "updated_by": "019d194e-f595-7d5f-a5bf-3609231ba43d"
      }
    }
  }
}

Step 4 - Ambil Detail Folder

Endpoint

• GET /api/v1/file-manager/folders/get/:uuid

Tujuan

• ambil detail satu folder (mis. untuk panel detail folder/breadcrumb context).

Contoh response

{
  "data": {
    "type": "file_manager_folder",
    "id": "folder-uuid",
    "attributes": {
      "name": "Documents",
      "name_normalized": "documents",
      "path_cache": "/Documents",
      "audit": {
        "created_at": "2026-03-31T08:52:03Z",
        "created_by": "019d194e-f595-7d5f-a5bf-3609231ba43d",
        "updated_at": "2026-03-31T08:52:03Z",
        "updated_by": "019d194e-f595-7d5f-a5bf-3609231ba43d"
      }
    }
  }
}