Melihat Metadata Media

Endpoint ini mengambil informasi detail metadata dari berkas media yang tersimpan di server Meta. Metadata mencakup tipe MIME, ukuran file, hash SHA-256, dan URL akses sementara. Gunakan endpoint ini untuk memverifikasi status media sebelum mengirimkannya ke pelanggan.

🛜 Endpoint

GET /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 GET "https://api.kirem.co/v1/media/18471948194819" \
  -H "Authorization: Bearer kirem_live_xxx"

🚦 Contoh Kode (Node.js)

const axios = require('axios');

axios.get('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("GET", 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_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 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
  }
}

⚠️ Kapan Menggunakan Endpoint Ini

• Sebelum mengirim media: Verifikasi bahwa media masih valid dan dapat diakses sebelum menyertakan media_id dalam pengiriman pesan.
• Setelah upload: Konfirmasi bahwa media telah berhasil disimpan di server Meta.
• Validasi integritas: Bandingkan hash sha256 untuk memastikan file tidak rusak atau berubah.

Catatan: URL pada data.url bersifat sementara dan akan kadaluarsa setelah jangka waktu tertentu. Jangan simpan URL ini untuk akses jangka panjang. Gunakan endpoint Download Media untuk mengunduh konten file.