Manajemen Media WhatsApp

API Media Kirem memfasilitasi pengelolaan berkas media (gambar, audio, video, dokumen) yang akan dikirim atau diterima melalui WhatsApp Business Platform. Endpoint ini terintegrasi langsung dengan penyimpanan Meta Cloud API.

📤 1. Mengunggah Media (Upload)

Mengunggah file media ke server Meta agar dapat digunakan dalam pengiriman pesan (menggunakan parameter id media).

Endpoint:

POST /v1/media

Content-Type:

multipart/form-data

Request Body (Form Fields):

• channel_id (Text - Wajib): ID saluran WhatsApp terdaftar.
• file (File - Wajib): Berkas biner media yang diunggah.

Contoh cURL Request:

curl -X POST https://api.kirem.id/v1/media \
  -H "Authorization: Bearer kirem_live_xxx" \
  -F "channel_id=chan-123" \
  -F "file=@/path/to/image.png"

Respons Sukses (200 OK):

{
  "status": 200,
  "message": "Media uploaded successfully",
  "data": {
    "id": "18471948194819"
  }
}

🔍 2. Mendapatkan Metadata Media

Mengambil informasi metadata dari berkas media yang tersimpan di Meta (seperti ukuran, tipe berkas, dan URL).

Endpoint:

GET /v1/media/:media_id

Query Parameters:

• channel_id (String - Wajib): ID saluran WhatsApp terdaftar.

Contoh cURL Request:

curl -X GET "https://api.kirem.id/v1/media/18471948194819?channel_id=chan-123" \
  -H "Authorization: Bearer kirem_live_xxx"

Respons Sukses (200 OK):

{
  "status": 200,
  "message": "Media metadata retrieved successfully",
  "data": {
    "id": "18471948194819",
    "messaging_product": "whatsapp",
    "url": "https://lookaside.fbsbx.com/whatsapp_v2/attachments/...",
    "mime_type": "image/png",
    "sha256": "d3b07384d113edec49eaa6238ad5ff00...",
    "file_size": 104857
  }
}

📥 3. Mengunduh Media (Download)

Mengunduh konten berkas biner media secara langsung sebagai streaming stream data.

Endpoint:

GET /v1/media/:media_id/download

Query Parameters:

• channel_id (String - Wajib): ID saluran WhatsApp terdaftar.

Contoh cURL Request:

curl -X GET "https://api.kirem.id/v1/media/18471948194819/download?channel_id=chan-123" \
  -H "Authorization: Bearer kirem_live_xxx" \
  --output downloaded_image.png

Respons Sukses (200 OK):

Server akan mengembalikan data biner gambar/file dengan header Content-Type yang sesuai (misalnya image/png).

🗑️ 4. Menghapus Media

Menghapus berkas media yang disimpan dari server penyimpanan Meta.

Endpoint:

DELETE /v1/media/:media_id

Query Parameters:

• channel_id (String - Wajib): ID saluran WhatsApp terdaftar.

Contoh cURL Request:

curl -X DELETE "https://api.kirem.id/v1/media/18471948194819?channel_id=chan-123" \
  -H "Authorization: Bearer kirem_live_xxx"

Respons Sukses (200 OK):

{
  "status": 200,
  "message": "Media deleted successfully",
  "data": {
    "success": true
  }
}