Saat menggunakan fitur-fitur Intelligent Media Services (IMS) seperti unggah aset media, pemrosesan media, dan pengeditan daring, Anda dapat mengonfigurasi peristiwa panggilan balik untuk memperoleh kemajuan dan status tugas secara real-time. Hal ini memungkinkan Anda menjalankan operasi bisnis lain berdasarkan peristiwa tersebut. Topik ini menjelaskan informasi dasar tentang metode panggilan balik dan peristiwa panggilan balik.
Metode panggilan balik
Ikhtisar
IMS mendukung metode panggilan balik permintaan HTTP dan antrian Simple Message Queue (SMQ) untuk menerima notifikasi peristiwa.
Permintaan HTTP: Panggilan balik HTTP dikirimkan secara otomatis untuk memberikan notifikasi peristiwa di IMS. Anda perlu menyediakan layanan HTTP untuk menerima pesan panggilan balik dan menentukan URL panggilan balik di konsol IMS atau saat memanggil API. Saat peristiwa terjadi, IMS mengirimkan permintaan HTTP POST ke URL panggilan balik. Notifikasi disampaikan dalam badan respons HTTP.
Antrian SMQ: Anda harus mengambil panggilan balik SMQ secara manual dari IMS. Berikan otorisasi IMS untuk mengakses SMQ, buat antrian baru atau gunakan antrian yang ada di konsol SMQ, lalu konfigurasikan nama antrian SMQ di konsol IMS atau saat memanggil API. Saat peristiwa terjadi, IMS mendorong pesan panggilan balik ke antrian. Anda perlu memeriksa pesan yang diterima di SMQ.
Perbandingan antara metode panggilan balik
Item | Permintaan HTTP | Antrian SMQ |
Keandalan | Jika layanan penerimaan pesan HTTP tidak normal, pesan mungkin hilang. Misalnya, pesan mungkin hilang jika layanan terganggu atau dimulai ulang. | Metode antrian SMQ lebih andal daripada metode permintaan HTTP. Hampir semua panggilan balik SMQ berhasil jika dikonfigurasi dengan benar. |
Keamanan | Jika Anda menggunakan metode permintaan HTTP, semua pengguna dapat mengirim permintaan panggilan balik ke URL panggilan balik yang ditentukan. Namun, Anda dapat menggunakan autentikasi panggilan balik untuk menyaring permintaan yang tidak valid dan meningkatkan keamanan metode permintaan HTTP. Untuk informasi lebih lanjut, lihat Autentikasi panggilan balik. | Metode antrian SMQ lebih aman daripada metode permintaan HTTP karena hanya pengguna yang berwenang yang dapat membaca dan menulis antrian pesan. |
Kemudahan | Metode permintaan HTTP lebih mudah daripada metode antrian SMQ karena Anda hanya perlu menyebarkan layanan penerimaan pesan. | Untuk menggunakan metode antrian SMQ, Anda harus mengaktifkan dan mengonfigurasi SMQ, serta mengembangkan dan menyebarkan program yang mengonsumsi pesan. |
Protokol panggilan balik
Metode panggilan balik | Deskripsi |
Permintaan HTTP |
|
Antrian SMQ | Pesan panggilan balik dalam format JSON. Untuk informasi lebih lanjut tentang contoh badan pesan dan deskripsi parameter yang sesuai, lihat Daftar peristiwa. |
Penentuan panggilan balik dan percobaan ulang
Metode panggilan balik | Hasil panggilan balik | Deskripsi percobaan ulang panggilan balik |
Permintaan HTTP | Setelah permintaan HTTP dikirim, IMS memeriksa kode status HTTP dalam respons yang dikembalikan oleh layanan penerimaan pesan HTTP. Jika kode status HTTP 200 dikembalikan, panggilan balik berhasil. Jika kode status HTTP selain 200 dikembalikan atau tidak ada respons yang diberikan dalam waktu 3 detik, panggilan balik gagal. IMS mengabaikan badan respons dan hanya menentukan apakah panggilan balik berhasil berdasarkan kode status HTTP. | Jika permintaan panggilan balik gagal dikirim karena konfigurasi yang salah, seperti URL panggilan balik yang salah atau kegagalan layanan penerimaan pesan HTTP, IMS mencoba mengirim permintaan panggilan balik dua kali lagi dengan interval 1 detik. Jika permintaan panggilan balik gagal dikirim setelah tiga percobaan, IMS membuang permintaan tersebut. |
Antrian SMQ | Jika Anda menggunakan metode antrian SMQ, IMS menentukan bahwa panggilan balik SMQ berhasil ketika pesan didorong ke antrian SMQ. | Jika pesan gagal didorong ke antrian karena konfigurasi yang salah, IMS mencoba mendorong pesan dua kali lagi dengan interval 1 detik. Sebagai contoh, pesan panggilan balik gagal dikirim jika IMS tidak diberi otorisasi untuk mengakses SMQ, titik akhir antrian bukan titik akhir publik, atau nama antrian salah. Jika pesan gagal didorong setelah tiga percobaan, IMS membuang pesan tersebut. |
Disarankan untuk menggunakan metode antrian SMQ karena lebih andal dibandingkan dengan metode permintaan HTTP. Hampir semua panggilan balik SMQ berhasil jika dikonfigurasi dengan benar.
Tipe peristiwa panggilan balik
IMS menyediakan peristiwa panggilan balik yang terkait dengan fitur-fitur seperti unggah aset media, pemrosesan media, dan pengeditan daring. Anda dapat mengonfigurasi peristiwa panggilan balik tertentu untuk memperoleh kemajuan dan status tugas secara real-time. Untuk informasi lebih lanjut, lihat Daftar Peristiwa.