ID Media

/v1/media/{media-id}

Dengan ID tertentu, gunakan endpoint ini untuk mengambil atau menghapus media Anda.

Sebelum Memulai

Sebelum Anda mengambil ulang yang dihapus, Anda harus mengunggah media Anda terlebih dahulu melalui /v1/media.

Mengambil

Setelah Anda berhasil mengunggah media, Anda menerima tanggapan yang berisi ID media. Gunakan ID tersebut dalam permintaan apa pun untuk mengambil media yang disimpan di klien API WhatsApp Business.

Proses untuk mengambil media ini juga digunakan saat pengguna mengirimkan gambar yang diterima oleh Webhooks Anda. Saat pesan dengan media diterima, klien API WhatsApp Business akan mengunduh media tersebut. Setelah media diunduh, Anda akan menerima notifikasi melalui Webhook Anda; gunakan ID media yang ditemukan di notifikasi itu untuk mengambil media.

Anda dapat mengaktifkan klien API WhatsApp Business untuk mengunduh media secara otomatis dengan Pengaturan Media Unduh Otomatis.

Contoh

GET /v1/media/media-id

Contoh: menggunakan contoh gambar yang diunggah di bagian sebelumnya:

curl -X GET \
  https://your-webapp-hostname:your-webapp-port/v1/media/4b5bf27b-8672-4d55-bc21-d096dc200d0f \
  -H 'Authorization: Bearer your-auth-token' 

Untuk mengirim contoh media ini ke sebuah file, gunakan parameter -o, seperti contoh di bawah:

curl -X GET \
  https://your-webapp-hostname:your-webapp-port/v1/media/4b5bf27b-8672-4d55-bc21-d096dc200d0f \
  -H 'Authorization: Bearer your-auth-token' \
  -o path/filename

Jika panggilan berhasil, Anda akan melihat tanggapan yang berisi status 200 OK dan data media biner.

Content-Type: image/jpeg or other appropriate media type
Content-Length: content-size

binary-media-data

Jika Anda menggunakan fitur seperti Postman, Anda akan melihat gambar. Jika Anda menggunakan fitur baris perintah, Anda akan melihat data biner. Jika Anda mengirim data ke file, Anda akan melihat gambar di browser file Anda.

Jika media tidak ditemukan, kode tanggapan 404 Not Found dikembalikan tanpa badan.

Jika Anda menerima pesan kesalahan yang berbeda, lihat Pesan Kesalahan dan Status untuk informasi selengkapnya.

Menghapus

Untuk menghapus media di klien API WhatsApp Business, kirim permintaan DELETE ke node media bersama dengan ID media yang ingin Anda hapus. Gunakan ID dari tanggapan untuk mengunggah media atau pesan media dari Webhooks.

Contoh

Permintaan:

DELETE /v1/media/media-id

Tanggapan yang berhasil akan menampilkan 200 OK dan null atau {}. Jika media tidak ditemukan, tanggapan akan menampilkan 404 Not Found dan tanpa badan. Jika Anda menerima pesan kesalahan yang berbeda, lihat Pesan Kesalahan dan Status untuk informasi selengkapnya.