Menghapus Media

Endpoint ini menghapus berkas media dari penyimpanan server Meta secara permanen. Gunakan dengan hati-hati — media yang sudah dihapus tidak dapat dikembalikan.

🛜 Endpoint

DELETE /v1/media/:media_id

📋 Parameter

Endpoint ini tidak memerlukan query parameter tambahan. Cukup sertakan media_id pada path URL dan header Authorization.

🚦 Contoh cURL Request

curl -X DELETE "https://api.kirem.co/v1/media/18471948194819" \
  -H "Authorization: Bearer kirem_live_xxx"

🚦 Contoh Kode (Node.js)

const axios = require('axios');

axios.delete('https://api.kirem.co/v1/media/18471948194819', {
  headers: { 'Authorization': 'Bearer kirem_live_xxx' }
}).then(res => console.log(res.data));

🚦 Contoh Kode (Go)

package main

import (
	"fmt"
	"net/http"
)

func main() {
	url := "https://api.kirem.co/v1/media/18471948194819"
	req, _ := http.NewRequest("DELETE", url, nil)
	req.Header.Set("Authorization", "Bearer kirem_live_xxx")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	fmt.Println("Status:", resp.Status)
}

🚦 Contoh Kode (PHP)

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.kirem.co/v1/media/18471948194819');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer kirem_live_xxx']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

✅ Respons Sukses (200 OK)

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

⚠️ Peringatan Penting

• Penghapusan bersifat permanen — media yang dihapus tidak dapat dikembalikan.
• Periksa referensi terlebih dahulu: Pastikan media tidak sedang digunakan oleh pesan yang masih menunggu pengiriman (pending messages). Menghapus media yang direferensikan oleh pesan tertunda dapat menyebabkan kegagalan pengiriman.
• Pastikan media_id valid dan Anda memiliki akses ke media tersebut. Akses ke media yang bukan milik Anda akan ditolak (403 Forbidden).