ApsaraVideo VOD, HTTP (ve HTTPS) geri aramaları ve Simple Message Queue (formerly MNS) geri aramaları aracılığıyla olay bildirimlerini destekler. Bu konuda olay türleri, geri arama yöntemleri, yapılandırmalar, protokoller, ortak parametreler, doğrulama, yeniden deneme ilkesi ve sık sorulan sorular (SSS) açıklanmaktadır.
Olay bildirimlerine giriş
ApsaraVideo VOD birden fazla depolama bölgesini destekler. Her bölge için olay bildirimlerinde benzersiz bir geri arama yöntemi ve Webhook adresi yapılandırabilirsiniz. Bir video yüklendikten ve işlendikten sonra ApsaraVideo VOD, ilgili bölge için yapılandırılan geri arama yöntemi ve Webhook adresine göre bir bildirim gönderir.
Geri arama gövdesi yalnızca HTTP URL'lerini döndürür. HTTPS URL'leri desteklenmez. HTTPS URL'lerinin nasıl alınacağı hakkında bilgi için bkz. Olay bildirimleriyle ilgili SSS.
Geri arama yöntemleri
ApsaraVideo VOD olay bildirimlerini almak için iki yöntemi destekler: HTTP (ve HTTPS) geri aramaları ve Simple Message Queue (MNS) geri aramaları.
-
HTTP (ve HTTPS) geri aramaları:
HTTP geri aramaları, ApsaraVideo VOD'dan olay bildirimlerini almanın pasif bir yoludur. Bu yöntemde, geri arama iletilerini almak üzere bir HTTP hizmeti dağıtır ve Webhook adresini ApsaraVideo VOD'da yapılandırırsınız. Bir olay gerçekleştiğinde VOD hizmeti bu adrese bir HTTP POST isteği gönderir ve olay bildirimi HTTP gövdesinde teslim edilir.
-
Simple Message Queue (formerly MNS) geri aramaları:
Simple Message Queue (formerly MNS) geri aramaları, ApsaraVideo VOD'dan olay bildirimlerini çekmenize olanak tanıyan aktif bir yöntemdir. ApsaraVideo VOD'a MNS erişim izni verdikten sonra Simple Message Queue (formerly MNS) içinde yeni bir kuyruk oluşturabilir veya mevcut bir kuyruk kullanabilir ve ApsaraVideo VOD'da olay bildirimlerini yapılandırabilirsiniz. Bir olay gerçekleştiğinde ApsaraVideo VOD geri arama içeriğini kuyruğa yazar. Ardından iletiyi Simple Message Queue (formerly MNS) kuyruğundan almanız gerekir. Simple Message Queue (formerly MNS) konsolunda kuyruk oluşturma ve ileti alma hakkında daha fazla bilgi için bkz. Kuyruk işlemleri.
HTTP ve MNS geri aramalarının karşılaştırılması
|
|
|
|
|
|
|
|
|
|
Webhook adresine herkes istek gönderebilir. Ancak yasa dışı istekleri filtrelemek ve güvenliği artırmak için geri arama kimlik doğrulamasını kullanabilirsiniz. Daha fazla bilgi için bkz. HTTP geri araması kimlik doğrulaması. |
|
|
|
|
Simple Message Queue (formerly MNS) hizmetinin etkinleştirilip yapılandırılmasını gerektirir. Ayrıca iletileri tüketmek için bir program geliştirip dağıtmanız gerekir. |
Geri callback protokolleri
-
HTTP geri aramaları
İstek: JSON gövdeli bir HTTP POST isteği. Her geri aramanın belirli gövde içeriği hakkında daha fazla bilgi için Olay türleri bölümünde başvurulan belgelere bakın.
Yanıt: ApsaraVideo VOD yanıt gövdesi içeriğini yok sayar.
-
Simple Message Queue (formerly MNS) geri aramaları
Alınan ileti içeriği JSON formatındadır. Her geri aramanın belirli gövde içeriği hakkında daha fazla bilgi için Olay türleri bölümünde başvurulan belgelere bakın.
Ortak geri callback parametreleri
Parametre | Tür | Açıklama |
EventTime | String | Olayın gerçekleştiği saat (UTC). Saat, yyyy-MM-ddTHH:mm:ssZ formatında ISO 8601 standardını takip eder. |
EventType | String | Olay türü. |
VideoId | String | Video ID'si. |
Status | String | İşleme durumu. Geçerli değerler:
|
Extend | String | Bir yükleme veya iş gönderme API işlemi çağırırken UserData parametresini belirtebilirsiniz. Bu parametre Extend alanını içeriyorsa özel kullanıcı verileri aktarılır ve olay tamamlama geri aramasında döndürülür. Maksimum uzunluk 512 bayttır. |
Geri callback doğrulaması ve yeniden denemeler
-
HTTP geri aramaları
ApsaraVideo VOD bir HTTP geri araması gönderdiğinde, alınan hizmet HTTP durum kodu 200 ile yanıt verirse geri arama başarılı kabul edilir. Durum kodu 200 değilse veya yanıt 5 saniye içinde zaman aşımına uğrarsa geri arama başarısız kabul edilir. ApsaraVideo VOD yanıt gövdesini yok sayar ve yalnızca HTTP durum kodunu dikkate alır.
Yanlış Webhook adresi veya anormal bir alma hizmeti gibi bir yapılandırma hatası nedeniyle geri arama başarısız olursa ApsaraVideo VOD en fazla üç deneme olmak üzere geri aramayı iki kez daha yeniden dener. Üç başarısız denemenin ardından ileti silinir.
-
Simple Message Queue (formerly MNS) geri aramaları
ApsaraVideo VOD bir Simple Message Queue (formerly MNS) geri araması gönderdiğinde, ileti Simple Message Queue (formerly MNS) kuyruğuna yazılırsa geri arama başarılı kabul edilir. Aksi takdirde geri arama başarısız kabul edilir.
Bir yapılandırma hatası nedeniyle ileti Simple Message Queue (formerly MNS) kuyruğuna yazılamazsa ApsaraVideo VOD en fazla üç deneme olmak üzere iki kez daha yeniden dener. Yapılandırma hatalarına örnek olarak ApsaraVideo VOD'a erişim izinlerinin verilmemesi, internet üzerinde olmayan bir kuyruk adresinin kullanılması veya yanlış bir kuyruk adı kullanılması gösterilebilir. Üç başarısız denemenin ardından ileti silinir.
Bir geri arama başarısız olduktan sonra ApsaraVideo VOD 1 saniyelik bir aralıkla yeniden dener. Geri arama toplam üç denemeden sonra hala başarısız olursa ileti silinir. Bildirimlerin güvenilirliğini sağlamak için Simple Message Queue (formerly MNS) geri aramalarını kullanın. Doğru yapılandırıldığında daha yüksek güvenilirlik sunarlar ve neredeyse her zaman başarılı olurlar.
Geri callback yapılandırması
HTTP ve MNS geri aramalarının yapılandırma prosedürleri farklıdır. Her ikisini de ApsaraVideo VOD konsolunda veya API/SDK kullanarak yapılandırabilirsiniz. Prosedürler ve sınırlar hakkında daha fazla bilgi için bkz. HTTP geri aramalarının nasıl kullanılacağı ve MNS geri aramalarının nasıl kullanılacağı.
Olay türleri
ApsaraVideo VOD aşağıdaki olay bildirim türlerini destekler:
Olay türü | Başvuru |
FileUploadComplete | |
ImageUploadComplete | |
StreamTranscodeComplete | |
TranscodeComplete | |
SnapshotComplete | |
DynamicImageComplete | |
AddLiveRecordVideoComplete | |
LiveRecordVideoComposeStart | |
UploadByURLComplete | |
UploadByURLComplete | |
CreateAuditComplete | |
VideoAnalysisComplete | |
UpdateMediaStorageClassComplete | |
RestoreMediaComplete | |
AttachedMediaUploadComplete | |
ProduceMediaComplete | |
DeleteMediaComplete | |
MediaBaseChangeComplete | |
SubmitMediaRefreshComplete | |
WorkflowTaskComplete |
SSS
Geri aramalardan HTTPS URL'lerinin nasıl alınacağı veya birden çok Webhook adresinin nasıl uygulanacağı gibi sorunlarla karşılaşırsanız bkz. Olay bildirimleriyle ilgili SSS.