Saat menggunakan Intelligent Media Services (IMS) untuk mengunggah aset media, memproses media, dan mengedit secara daring, Anda dapat mengonfigurasi event callback untuk menerima pembaruan tepat waktu mengenai progres dan status Tugas, sehingga memungkinkan koordinasi operasi bisnis berikutnya.
Metode callback
Pengantar
IMS mendukung dua metode callback untuk menerima notifikasi event: permintaan HTTP dan antrian MNS.
-
Permintaan HTTP: IMS mengirimkan notifikasi event ke layanan Anda. Anda men-deploy layanan HTTP untuk menerima pesan callback dan mengonfigurasi URL callback di Konsol atau melalui pemanggilan operasi API. Saat suatu event terjadi, server IMS mengirimkan permintaan HTTP POST ke URL callback dengan isi pesan dalam badan HTTP.
-
Antrian MNS: IMS menuliskan notifikasi event ke antrian pesan. Anda memberikan otorisasi kepada IMS untuk mengakses Simple Message Queue (formerly MNS), membuat atau memilih antrian yang sudah ada, lalu mengonfigurasi nama antrian tersebut di Konsol atau melalui pemanggilan operasi API. Saat suatu event terjadi, IMS menuliskan konten callback ke antrian tersebut. Anda kemudian dapat membaca antrian untuk mengambil pesan-pesannya.
Kelebihan dan kekurangan
|
Perbandingan |
Permintaan HTTP |
Antrian MNS |
|
Keandalan |
Pesan dapat hilang jika layanan HTTP penerima mengalami masalah, seperti crash atau restart. |
Jika konfigurasinya benar, callback pesan hampir selalu berhasil. Metode ini menawarkan keandalan yang lebih tinggi. |
|
Keamanan |
Klien HTTP mana pun dapat mengirim permintaan ke URL callback. Anda dapat menggunakan autentikasi callback untuk menyaring permintaan yang tidak sah. Untuk informasi selengkapnya, lihat Autentikasi callback. |
Hanya pihak yang berwenang yang dapat membaca dan menulis ke antrian pesan. Metode ini menawarkan keamanan yang lebih tinggi. |
|
Kemudahan |
Lebih mudah diatur. Cukup deploy layanan untuk menerima pesan. |
Memerlukan pengaktifan dan konfigurasi MNS. Anda juga harus mengembangkan dan men-deploy program untuk mengonsumsi pesan-pesan tersebut. |
Protokol callback
|
Metode callback |
Deskripsi |
|
Permintaan HTTP |
|
|
Antrian MNS |
Pesan yang diterima dari antrian berupa string JSON. Untuk contoh isi pesan dan deskripsi parameternya, lihat Daftar event. |
Validasi dan retry callback
|
Metode callback |
Apakah callback berhasil? |
Upaya Ulang Callback |
|
Permintaan HTTP |
Callback dianggap berhasil jika layanan penerima merespons dengan kode status HTTP 200. Callback gagal jika kode status bukan 200 atau waktu respons melebihi 3 detik. IMS hanya menentukan keberhasilan berdasarkan kode status HTTP dan mengabaikan isi badan respons. |
Jika callback gagal karena masalah konfigurasi seperti URL callback salah atau layanan penerima tidak tersedia, IMS akan mencoba ulang sebanyak dua kali lagi dengan interval 1 detik. Jika ketiga percobaan gagal, pesan tersebut akan dibuang. |
|
Antrian MNS |
Callback dianggap berhasil jika pesan berhasil dituliskan ke antrian MNS. Jika tidak, callback dianggap gagal. |
Jika penulisan pesan ke antrian MNS gagal karena masalah konfigurasi, IMS akan mencoba ulang sebanyak dua kali lagi dengan interval 1 detik. Contoh masalah konfigurasi meliputi tidak memberikan akses IMS ke Simple Message Queue (formerly MNS), menggunakan alamat antrian yang bukan jaringan publik, atau menentukan nama antrian yang salah. Jika ketiga percobaan gagal, pesan tersebut akan dibuang. |
Callback antrian MNS memberikan keandalan yang lebih tinggi. Jika konfigurasinya benar, callback pesan hampir selalu berhasil.
Jenis event callback
IMS menyediakan event callback untuk unggahan aset media, pemrosesan media, pengeditan daring, dan operasi lainnya. Anda dapat mengonfigurasi event callback spesifik untuk menerima pembaruan tepat waktu tentang progres dan status Tugas. Untuk informasi selengkapnya, lihat Daftar event.