fm_be/docs/file-manager-attachment.md

File Manager

Attachment (Step by Step)

A. Tambah Attachment

Endpoint

• POST /api/v1/file-manager/attachments/create

FE kirim request ini

{
  "data": {
    "type": "file_manager_attachment_create",
    "attributes": {
      "file_id": "file-uuid",
      "ref_type": "helicopter",
      "ref_id": "business-entity-uuid",
      "category": "document",
      "sort_order": 0,
      "is_primary": false
    }
  }
}

Keterangan:

• file_id, ref_type, ref_id wajib
• category opsional
• sort_order opsional (default 0)
• is_primary opsional (default false)

B. Lihat Attachment by Reference

Endpoint

• GET /api/v1/file-manager/attachments/get-all?ref_type=<type>&ref_id=<id>

Contoh

• GET /api/v1/file-manager/attachments/get-all?ref_type=helicopter&ref_id=business-entity-uuid

Catatan urutan default:

• jika query sort tidak dikirim, urutan default adalah sort_order ASC, created_at DESC
• artinya untuk sort_order yang sama, attachment terbaru tampil lebih dulu

C. Detail Attachment

Endpoint

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

D. Hapus Attachment (Detach)

Endpoint

• DELETE /api/v1/file-manager/attachments/delete/:uuid

Contoh response

{
  "data": {
    "type": "file_manager_attachment_delete",
    "attributes": {
      "detached": true
    }
  }
}

Ringkasan

1. create relation file -> entity bisnis
2. list by ref_type + ref_id
3. get detail relation
4. delete relation (detach)