Tüm Ürünler
Search
Belge Merkezi

ApsaraVideo VOD:Olay bildirimi

Son Güncelleme:Oct 05, 2026

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.

Not

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ı


Öğe


HTTP geri araması


MNS geri araması (Önerilen)


Güvenilirlik


HTTP ileti alma hizmetiniz anormal durumdaysa (örneğin çökme veya yeniden başlatma yaşanıyorsa) iletiler kaybolabilir.


Daha güvenilir. Doğru yapılandırma ile geri aramalar neredeyse her zaman başarılı olur.


Güvenlik

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ı.


Mesaj kuyruğuna yalnızca yetkili taraflar okuma ve yazma işlemi yapabildiği için daha güvenlidir.


Kullanım kolaylığı


Entegrasyonu daha kolaydır. Tek yapmanız gereken bir ileti alma hizmeti dağıtmaktır.

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:

  • success

  • fail

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.

Not

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

Video yüklemesi tamamlandı

ImageUploadComplete

Görüntü yüklemesi tamamlandı

StreamTranscodeComplete

Tek bir çözünürlük için kod dönüştürme tamamlandı

TranscodeComplete

Tüm çözünürlükler için kod dönüştürme tamamlandı

SnapshotComplete

Video anlık görüntüsü alma işlemi tamamlandı

DynamicImageComplete

Hareketli görüntü oluşturma tamamlandı

AddLiveRecordVideoComplete

Canlı akış kaydı tamamlandı

LiveRecordVideoComposeStart

Kaydedilmiş videonun birleştirilmesi başladı

UploadByURLComplete

URL'den video yüklemesi tamamlandı

UploadByURLComplete

URL'den kodu dönüştürülmüş akış yüklemesi tamamlandı

CreateAuditComplete

Manuel inceleme tamamlandı

VideoAnalysisComplete

Ses ve video analizi tamamlandı

UpdateMediaStorageClassComplete

Medya varlığı depolama sınıfı değişikliği tamamlandı

RestoreMediaComplete

Medya varlığı geri yüklemesi tamamlandı

AttachedMediaUploadComplete

Ek medya varlığı yüklemesi tamamlandı

ProduceMediaComplete

Video düzenleme ve birleştirme tamamlandı

DeleteMediaComplete

Medya varlığı silme işlemi tamamlandı

MediaBaseChangeComplete

Temel medya varlığı bilgisi değişikliği tamamlandı

SubmitMediaRefreshComplete

Ses/video temizleme veya ön getirme tamamlandı

WorkflowTaskComplete

İş akışı görevi tamamlandı

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.